- > PHP 5.3
- Apache 2.2 with mod_rewrite enabled and access to VHOSTs configuration (not tested without, but could also work)
(For Experts: It can also work on other web servers than Apache, although I haven’t tested it. Make sure the rewrite rules are configured correctly, look at the rules in public/.htaccess for reference)
Sample Apache VHOST Configuration
NameVirtualHost *:80 <VirtualHost *:80> DocumentRoot /path/to/dir/where/you/extracted/SimpleCMS # Make sure you have registered this with a DNS server # or have an entry in your computer's host file (C:\Windows\System32\drivers\etc\hosts or /etc/hosts on *NIX) ServerName your_domain.com <Directory "/path/to/dir/where/you/extracted/SimpleCMS"> Options FollowSymLinks ExecCGI Includes AllowOverride All Order allow,deny Allow from all </Directory> </VirtualHost>
How to install
- Get a stable package (simple_cms_vX.X.X) from the
Downloadssection of Github, these are well tested
- Unzip the contents of the downloaded Package, to a folder in the document root of your web server, for example
- Setup a new VHOST and point its document root to the directory of the Simple CMS install, for example
/var/www/simple_cms. Don’t forget to update your
C:\Windows\system32\drivers\etc\hostsfile with the server name of your VHOST!
- Start your server and open the URL of your VHOST in a Browser — you should see the Getting Started Page
Just clone the repository with
git clone git://github.com/CHH/Simple-CMS /your/desired/path and initialize all dependencies with
git submodule init and
git submodule update.
To create a page, simply put a file with the extension “.txt” into the “pages” folder.
If the Root of the Domain (e.g. http://example.com/) gets requested, the page named
“index.txt” gets rendered.
If you want subpages in the style of “http://example.com/foo/bar” just create
a folder “foo” in the “pages” directory. Then create the file “bar.txt” in the foo
folder. This can be done infinitly, so you can organize your pages as you want.
Pages are formatted with the Textile simple markup Language. You can mix in normal HTML too.
The root folders
The root of your install has various folders
Want to contribute?
Simple CMS is licensed under the MIT License, and thus Open Source.
To contribute just fork the git repository at http://github.com/CHH/Simple-CMS
and send me pull requests either by mail <firstname.lastname@example.org> or via github.
I’m always open for new features and feedback, just send me a mail or a Message on
Github and we discuss it.
Coding is not your thing? But you’re good at writing?
Good documentation is also a feature! Just head over to the Wiki
and write about your favourite feature of Simple-CMS!
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
© 2010 Christoph Hochstrasser