From Skypanther Wiki

Contents 1 FestOS™ Installation 1.1 1. Pre-installation 1.2 2.FestOS Installation 1.3 3. Configuration 1.4 4. Page Creation

FestOS™ Installation

Installing FestOS involves a these phases:

1. Pre-installation
2. FestOS installation
3. Configuration
4. Page creation

1. Pre-installation

Prior to installing, you will need to:

• Create a MySQL database on your web host using the control panel or other tools they provide
• Determine the server address for your database server (localhost, mysql.yourdomain.com, etc.)
• Record the MySQL user name and password for your database access

2.FestOS Installation

To install FestOS:

1. Unzip the distribution file on your local hard drive
2. Using a text editor (Notepad, Dreamweaver, etc.) edit the core/config.php file:
   1. Enter the database name, server, and credentials you determined above. Optionally, enter a prefix that will be appended to all the table names used by FestOS. This enables you to install FestOS into a database that contains other tables
   2. Enter the full URL to where you will be installing FestOS on your web site (e.g. http://www.yourwebsite.com/festos/)
   3. Don't change anything below the part where it says "DO NOT CHANGE ANYTHING BELOW THIS POINT!!!"
3. Save your changes.
4. Using a text editor (Notepad, Dreamweaver, etc.) edit the core/lang.php file:
   1. Make sure to edit each of the variables to match the names of your organization, your festival name, and so forth. These values are used to create the pages the public and applicants to your festival will see.
   2. Make sure to scroll down and update each of the "photolang" variables. These are used to create text your applicants will see during the application process.
   3. Save your changes.
5. Upload all of the files to your web server. You may put the files into a folder or right at your web root. Just make sure it matches what you set in the config.php file.
6. (Linux/UNIX systems) Set 777 file permissions on the following directories and files (where path is the directory in which you installed FestOS):
   • path/cache/ (directory and the files & directories it contains)
   • path/vendorimages/ (directory and the files it contains)
7. With your browser, load http://www.yourwebsite.com/path/install/index.php substituting the directory name of where you put the FestOS files for path. The installer adds the database tables and starting information.
8. Delete the install directory and all the files and directories it contains.

Suggestion

We suggest you create a robots.txt file (or edit your existing file) and place it in the root directory of your web space. In this file, add these lines:

User-agent: *
Disallow: /addons/
Disallow: /admin/
Disallow: /core/
Disallow: /css/
Disallow: /images/
Disallow: /js/
Disallow: /templates/
Disallow: /includes/
Disallow: /cache/

These will limit the amount of scanning that the search engine robots perform on FestOS components that don't really need to be searchable.

3. Configuration

1. Visit http://www.yourwebsite.com/path/admin/login.php and log in using the credentials that you specified during the installation.
2. Under the FestOS Configuration menu, choose Site Configuration.
3. Configure the various fields on the configuration page and click the Submit button at the bottom.
4. Choose FestOS Configuration, Site Admins. You can either modify the existing admin account or create a new one for yourself. Make sure to change the password or delete the admin account if you use a different administrator account. If you retain the skypanther account, we will be able to log onto your festival site in the event you need support or help. Feel free to delete it if you'd like.
5. Choose Festival Management, Categories. These are the artist categories under which your applicants will be listed. Edit as required.
6. Choose Festival Management, Application Fees and Dates. Configure your fees and application deadlines.
7. Choose Festival Management, Contacts/Organizers. If you use the contacts page, these are the people who will be listed. Edit as required.

Some sample artist and exhibitor records have been included. You can use these to practice editing, displaying, and so forth. Most likely you will want to delete these before publishing your site.

4. Page Creation

FestOS is designed to integrate into an existing web site. Of course, you can easily create a whole new site if you don't have one already. Let's start first with the integrating route.

You will need to create or modify up to nine (9) pages. These will need to be named something.php, for example, apply.php (not apply.html). These will be for the following pages:

• Applications
• Artist listings
• Exhibitor listings
• Entertainer listings
• Food vendor listings
• Festival contacts
• Performance schedule listing
• Festival sponsors
• Contest winners

Of course, not every festival will need each of these pages. If you don't judge winning artists for your festival, you won't need the winners page for example.

As the very first line of the file, enter:

<?php require_once('core/core.php'); ?>

Then, in the body of the pages, you will need to add code like the following:

 <?php
 require_once('festos_apply.php');
 ?>

Check out the directory where you installed FestOS. You'll see nine files called festos_something.php. These match up with the preceding list. There are also a series of demo_name.php files that you can check out to see how this is done.