To start working with Couch, you need to have a regular HTML coded site in hand.
Each of the above mentioned HTML files, for Couch, is a template.
Couch works by retrofitting into these templates.
Since the templates used by Couch are regular HTML files, any of your existing static HTML sites too can be easily ported to Couch with minimal effort.
Please see the following tutorial, where we use Couch to build a full fledged site, for a step-by-step illustrated guide on how to install Couch - Building a real-world site.
HOOKING UP COUCH INTO THE TEMPLATES
IMP. To make the following changes you need to be logged in as the super-admin (the first account created by Couch during its installation). If you are not already logged in as super-admin, do so now else the following procedure will not work.
Once Couch is installed, the next step is to hook it up into the templates.
Three steps are required to accomplish this -
- Since Couch is a PHP application, in order to make to your HTML templates compatible with it you need to change their extensions from '.html' or '.htm' to '.php'.
For example, if about-us.html is a template that you wish to be managed by Couch, rename it as about-us.php.
Accessing http://www.yoursite.com/about-us.php should show up the page just the way it was when it had a '.html' extension.
- Once the template has been made a '.php' file, two lines of PHP code need to be added to it.
Open the template in a text editor (any plain text editor will do fine. We recommend using Notepad++. It is free and awesome).
At the very top of the page, add the following line -
<?php require_once( 'couch/cms.php' ); ?>[IMP. It is important that you place it at the very top so that it becomes the first line of your template.]
Add the following as the LAST line of your template -
<?php COUCH::invoke(); ?>That is it. That is all the PHP that you'll ever need to write for using Couch.
- As the final step, you'll need to execute the template - i.e. access it through the browser.
For example, if about-us.php was the template, upload it back to your server and access http://www.yoursite.com/about-us.php through a browser.
[IMP. This is something you'll come across often - for your changes to show up in the admin panel, you'll need to run the modified template in the browser while being logged in as the super-admin]
If everything goes right, nothing should appear to have changed. The page should look exactly the same in the browser as it did before. However, now when you visit Couch's Admin Panel (http://www.yoursite.com/couch/) you should see that about-us.php has been added to the list of templates that are managed by Couch.
Once we have Couch hooked into the template, we can place Couch Tags in the template to make Couch work its magic.