This framework is created by Isa Jansson isa.jansson@hotmail.com as a part of the course "Databas driven web applications with PHP and MVC" at Blekinge Institute of Technology. This framework is based on Lydia wich is created by Mickael Roos - lecturer at BTH.
- PHP
- SQLite
- Writable directorys site/data (chmod 777)
To install this framework you can either clone from GitHub at http://github.com/IsaJansson/Oden or download the zip-file from the same place. When the download is complete make site/data writable and then point your browser to the folder you put Oden in and follow the instructions.
Some servers need to have a rewrite base which is set in the .htaccess file. if you have any problems during the set up of Oden this could be the problem. To solve it you simply change the following row to the correct path on your server. RewriteBase /~isja13/phpmvc/me/projekt/oden/. If you dosent need the rewrite base you put a # in front of that row.
When the installation is done you can start using the framework. There are two users initiated, root:root is the administrator and doe:doe is a regular user. You can create your own user and it will connect your email with gravatar and fetch a profile pricture if you have one. If you don't have one you can create one at http://gravatar.com.
If you want to know what is included in this framework you can find the ducumentation in the module controller. In module/index you will find a list of all controllers in the sidebar and if you click on them you will se the specific information for each controller and its methods.
To create a new page you simply go to content/create and set the 'Type' as 'page'. You can choose different filters which affect how the content will be displayed. The 'Key' is what your page will be named in the URL.
To create a blogpost for your new blog you follow the steps of creating a new page only you set type as 'post' instead of 'page'.
To change logo, title or slogan on your site you go to site/config.php and at the bottom on that file you will find these settings. At the same place you can alter the footer as well. Right above these settings you will find the settings for the menu. There is a base-style in Oden which is based on semantic grid layout. This style is easy to overide in the site-specific stylesheet you will find in site/themes/mytheme/style.css. The colorscheme used as default in Oden is set in this site-specific stylesheet. If you want to change the base theme of Oden you need to make theme/grid writable as well due to its use of lessphp.
If you want to change more than described above you have a site controller in site/src/CCMyController. With this controller you can set what you want to be displayed and how. The functions in that controller is connected to the different views in the same directory. If you only want to change the page that is already displayed you can change the page id. The page id you find in the first row in the index-function in CCMyController $content = new CMContent(5);. To create new pages in the site and keep the about-page you need to copy the existing ones and change the page id. when you made a new function in that controller you simply add it to the menu-array in config.php and it will show in your menu.
By Edward Z. Yang is used to filter and format HTML. You can read more about what it does on it's website http://htmlpurifyer.org
- Version: 4.6.0
- License: LGPL
- Oden path:
src/CTextFilter/htmlpurifyer-4.6.0-standalone - Used by:
CTextFilter
By Michel Fortin is used to filter text to HTML and is an extension to PHP Markdown. If you want to learn more about it visit their website http://michelf.com/projects/php-markdown
- Version: 1.2.8
- License: BSD-style open source license or GNU
- Oden path:
src/CTextFilter/PHP-Markdown-Extra-1.2.8 - Used by:
CTextfilter
By Michel Fortin is used to improve typography on the web. This is based on the concept of Markdown by John Gruber. If you want to learn more about SmartyPants typographer you can do so on their website http://michelf.com/projects/php-smartypants
- Version: 1.0.1
- License: BSD-style open source license
- Oden path:
src/CTextFilter/PHP-SmartyPants-Typographer-1.0.1 - Used by:
CTextFilter
By Leaf Corcoran is used to compile LESS into CSS using PHP. Visit their website for more information http://leafo.net/lessphp
- Version: 0.4.0
- License: Dual license, MIT LICENSE & GPL VERSION 3
- Oden path:
theme/grid/lessphp - used by:
theme/grid/style.php
By Tyler Tate is used to do a grid layout throgh LESS. Learn more on their website http://semantic.gs
- License: APACHE LICENSE 2.0
- Version: 1.2
- Oden path:
theme/grid/semantic.gs - Used by:
theme/grid/style.less' & 'theme/grid/style