The main configuration file does NOT exist!
'; echo 'Click '; html_link('./install/index.php', $text = 'here', $status = 'Install S9Y_Conf', $target = ''); echo 'to installS9Y_Conf.
'; } exit; } // Installed if(!defined('S9YCONF_INSTALLED')) { // If no headers are sent, send one if (!headers_sent()) { header("Location: http://" . $_SERVER['HTTP_HOST'] . dirname($_SERVER['PHP_SELF']) . "/install"); }else{ echo 'The main configuration file does NOT exist!
'; echo 'Click '; html_link('./install/index.php', $text = 'here', $status = 'Install S9Y_Conf', $target = ''); echo 'to installS9Y_Conf.
'; } exit; } debug_msg ("FILE: ".__FILE__,3); db_connect(); html_header("S9Y_Conf Documentation"); ?>is an application developed to assist with the configuration and management of Serendipity (S9Y) installations.
Setting up a Serendipity installation can be as simple as copying the distribution files into some webspace, but often involves more tasks such as webserver configuration.
is designed to partially automate installation tasks by using templates to create scripts or configuration files, for example an Apache configuration suitable for S9Y. You can modify existing templates or create new ones to suit your own circumstances, easing the task of making multiple installations even over a period of time.
Other uses are performing upgrades to multiple installations on the same server, where the same tasks need to be performed repetitively. can also be a handy reference to all the blogs you have installed on your server.
When you first open you will be redirected to the installation routine.
Installation is a semi-automatic process that will lead you step by step through creating the configuration files and database tables required. During the installation if file/directory permissions need to be modified, then you will be notified with an error message which will also provide a solution.
Tables are created in your database using a prefix on the table names, to allow you to use an existing database while keeping separate from your other applications.
Once the installation has completed any write permissions on the directory can be removed.
After the installation has been completed you will be able to start using to record your Serendipity installations, and create the neccessary configurations for your webserver etc..The overiding theme of is the use of templates to create output relevant to each individual blog installation. Templates help you to create required configurations for your webserver, and reduce the time it takes to complete a new installation.
Templates are user defined, so you can customise them to suit your environment, and also can contain user defined variables. There is a small set of templates and variables to get you started.
Initially you will want to add your blog installation to the Blogs list, and then view a template's output.
On the left of each page is a navigation menu with the the three main areas of , which are variables, templates, and blogs. Clicking any of these links will take you to a list, where you will be able to add/edit/delete items.
The variables section is where you will find all the template variables, which are used in templates, where they are substituted with their content.
Variables always have a unique name which uses upper case characters, and may contain spaces. You will also be able to include other variables within a variable, allowing complex variables to be built from smaller building blocks. Variables can be nested and are expanded in a recursive manner so a variable can contain another variable that itself contains yet another variable.
There are variables that are hard coded into the program, the names of which you can not use as the name for one of your variables.
The reserved variables are:
| Variable | Description | Example |
|---|---|---|
| {NOW} | replaced with the system time as an RFC 2822 formatted date | |
| {S9YCONF} | replaced with this programs name and version number | |
| {BLOGID} | replaced with the numeric system id of the blog | 12 |
| {BLOGNAME} | replaced with the blog name entered in the blog data | Test S9Y installation |
| {BLOGPATH} | replaced with the blog path entered in the blog data | /home/user1/public_html/blog |
| {BLOGUSER} | replaced with the local user entered in the blog data | user1 |
| {BLOGURL} | replaced with the blog url entered in the blog data | http://myhost.foo.bar/~user1/blog/ |
| {TPLID} | replaced with the numeric system id of the template | 7 |
| {TPLNAME} | replaced with the template name entered in the template data | Apache |
| {TPLDESC} | replaced with the template description entered in the template data | Suggested S9Y Apache configuration |
When you use a variables in another variable, or within a template, it MUST always be enclosed with braces, '{' and '}', so that can recognise where the variables are.
The templates section is where you will find all the templates, which you can process along with blog data to create configuration files etc. for your server.
Each template has a unique name, a description, and content. The content of a template can contain any of the variables you have created along with the reserved variables detailed above.
When you use a variables in a template, or within another variable it MUST always be enclosed with braces, '{' and '}', so that can recognise where the variables are.
The blogs section is where you will find entries for each of the individual blogs you have entered, which you can process along with a template either one at a time or collectively.
Each blog entry has a unique name, the system path to it's location, the system name of the owner, and a url.