Seditio - Website engine - Guide

# Seditio v101

PHP/MySQL Website engine
Copyright Neocrome - http://www.neocrome.net
This guide updated : 2006-mar-15
Introduction
Requirements
Licences, copyrights and disclaimers
History
New installation
Upgrade from Seditio v100
Upgrade from Land Down Under v802
Get more help...
Credits
Links

## Introduction

Seditio is a framework, it's a set of PHP files that reads and stores datas in a MySQL database, and sends those datas to clients as HTML pages, through skin files (also called "templates").

The key features are :

- MySQL database driven.
- Skinnable (full control over the layout and the HTML pages).
- Multi-leveled user management.
- Built-in support for world-wide languages.
- Built-in support for plugins and extensions.
- Fast and scalable.

## Requirements

[Back to top]

- A webserver !

  Apache is the most well known and recommended, but any other serious HTTP server should work.

- PHP 4.3.0 or newer

  Seditio should work with most of older 4.x PHP version, but if your host still have such a rusted thing, please consider the move to a more "up-to-date" server.

- A MySQL database

  Any version younger than 2 years should be enough.
  But recent version of MySQL are recommended.

- A tool to manage the SQL database

  ... the most common is phpMyAdmin.
  There's no auto-installer in Seditio on purpose, this to force you to have a basic knowledge of such a tool.
  If you're planning to run a PHP/MySQL website without a database manager, expect troubles.

- A basic knowledge of HTML

  Required, if you're lacking this, please consider the reading of HTML tutorials before running a website.

- A basic knowledge of PHP

  If you're able to open a file with a text editor, and then able to put few values at the right place without messing the rest of the file, it's fine, you can consider yourself as enough-PHP-experienced-for-Seditio.

## Licences, copyrights and disclaimers

[Back to top]

Important: Seditio is not an open source software product.

- Overall

  Ownership rights and intellectual property rights in the Seditio software shall remain with Neocrome. This software is protected by copyright laws and treaties. Title and related rights in the content accessed through the software is the property of the applicable content owner and may be protected by applicable law. This license gives you no rights to such content. Authorisation to remove copyright notices can be obtained from Neocrome for a one time fee, see below.

- Licence for personal and non-profit users

  By default, Seditio is distributed under this licence.
  This free licence do NOT allow you to remove the copyright notice in the footer of all the page produced by Seditio (The link "Powered by...").
  You are free to modify the source code for your own use, modified source code may not be redistributed.

- Licence for commercial websites

  If you site is commercial and so making profits, you'll have to order a "Commercial Licence", please see Neocrome Services here.
  This Commercial Licence allow you to remove of the footer copyright notice ("Powered by Seditio").
  This licence authorises you to remove the output of copyright notices, it does not give you authorisation to remove any copyright notices in the script source header files nor any other rights. You are free to modify the source code for your own use, modified source code may not be redistributed.

- Copyright removal

  If your website is not making profits, but you still want to remove the "Powered by Seditio" link, you can order a "Copyright removal" at Neocrome Services.

- Scope of grant

  You may:
  - Customise the software's design to suit the needs of your own web site.
  - Produce and distribute modification instructions, skin packs or language packs provided that they contain notification that it was originally created by Neocrome. The modifications instructions you personally create are not owned by Neocrome so long as they contain no proprietary coding from Seditio.
  You may not:
  - Use Seditio for illegal activities.
  - Reverse engineer, disassemble, or create derivative works based on Seditio for distribution or usage outside your website.
  - Distribute Seditio without written consent from Neocrome.
  - Permit other individuals to use Seditio except under the terms listed above.

- Third party modifications

  Technical support will not be provided for third-party modifications to the software including modifications to code, skin packs, and language packs to any license holder. If Seditio is modified using a third-party modification instruction or otherwise, technical support may be refused to any license holder.

- Disclaimer of warranty

  Seditio is provided on an "as is" basis, without warranty of any kind, including without limitation the warranties of merchantability, fitness for a particular purpose and non-infringement. The entire risk as to the quality and performance of this software is borne by you.

## History

[Back to top]

Please see the history pages at Neocrome.net.

## New installation

[Back to top]

1. Get the latest Rar pack

   Download and extract the latest version from www.neocrome.net (and here only ! Any other distribution is illegal).

2. Main configuration entries

   Open the file datas/config.php, and fill up parameters about your MySQL database.
   Do not change settings that you do not understand yet !
   Please notice that most of the request for technical support are caused by erroneous settings or typos in this area. So if get an error message saying that Seditio or PHP cannot connect to the database, first check that the host name, database name, user name and password are ok. If you have a doubt, ask your hosting provider for the correct values.

3. Upload files to your server

   Seditio can manage an unlimited count of skins (HTML layouts), but one is usually enough.
   The default skin is set in /datas/config.php, by default it's "manta".
   The one named "manta_intl" looks exactly the the same, with extra support for a full localization, you can delete the folder /skins/manta_intl/ if your site is in english.
   Do not upload the folder /docs, its not required by the engine.

4. Allow file writing for some folders

   'CHMOD 777' folders (to allow files writing, do this with your FTP client) :
   /datas/defaultav/
   /datas/avatars/
   /datas/photos/
   /datas/signatures/
   /datas/thumbs/
   /datas/tmp/
   /datas/users/

5. Create the SQL database

   Open a MySQL remote manager (PHPmyAdmin is the most famous).
   Select your database, then in the tab 'SQL' create tables with the SQL script : docs/seditio-createnew-101.sql
   (With the button 'Browse', point to the location of the file on your computer, then run the script with 'Go')

6. Create your account

   Open your home URL with a browser, select 'login', then 'register', to create your account, and once done, log-in.
   Note that the first user to register is automatically activated and assigned the group "Administrators".

7. It's done !

   Not working ?
   Bad luck, so restart from the beginning and follow the steps carefully, and if after this second try the result is the same, head for the forums, there's several pinned topics about common pitfalls, issues and troubleshooting. Please put your website in your profile there, so the helpers can see the problem "live".

## Upgrade from Seditio v100

[Back to top]

1. Replace the core files

   Replace all the files from the folder /system/
   Replace all the files from the folder /plugins/statistics/
   Replace all the files from the folder /plugins/search/
   Upload the folder /plugins/recentitems/, and install this plugin with the plugin manager, if needed.

2. SQL database

   No changes in the structure of the SQL database.

3. Skin files

   In polls.tpl, add the tag {POLLS_COMMENTS_DISPLAY} near {POLLS_COMMENTS}, it should look like this :
   Comments: {POLLS_COMMENTS}{POLLS_COMMENTS_DISPLAY}

## Upgrade from Land Down Under v802

[Back to top]

Please go to the Upgrade section at Neocrome.net, there you will find a tool to upgrade the database and all the documentation needed for the skins and the plugins.

## Get more help...

[Back to top]

- Online manual, general configuration, FAQ, articles, etc.
- Neocrome forums, to meet other webmasters, and technical support.
- Licence and services, to order specific services and support Neocrome.Net

Feedback and comments are welcome in forums at www.neocrome.net
Please do not email or send private messages to request technical support, use forums instead !

## Credits

[Back to top]

- Developer :

  Olivier C. - Coder and designer, Neocrome administrator

- Forum moderators and contributors :

  Daniel "riptide" T. : Additional coding
  Mikko "Arkkimaagi" T. - CSS guru and Textboxer
  Thomas "schneebi" S. : Technical support
  Geoffrey "Viral Byte" B. - Additional coding Jukka "nOxiOu$" H. - Forum moderator
  Sazanov "Antony" A. - LDU Russia
  Dawid "SDK" P. LDU Poland

- And a big thanks goes to...

  - Zarkof - Original design of the country flags.
  - The Neocrome clients and licence holders.
  - Our donators.