Historio: » webmasters

Installation guide

Follow this link to download the software and unzip the distribution in a temporary folder on your computer.

Hosting

The server that will host Pâturage must provide PHP and MySQL. In order to create thumbnails in photo galleries, the graphic library GD is also needed.

Pâturage has been tested with the following configurations:

  • PHP 4.4
  • MySQL 4.0 et 5.0
  • GD 2.0

The PHP environment must have write permissions on the folder where the shared files will be stored.

Follow this link to get a list of the tested hosting services.

Configuration

In folder «agordoj» of the Pâturage distribution, rename the file «agordoj.ekzemple.php» into «agordoj.php». Open this file in a text editor and modify the parameter values according to the desired configuration. You should only modify the values at the right side of the arrows.

Here is the list of parameters:

chefa titolo

The main title of your Pâturage site.

When visiting your site, this title will be displayed:

  • in the title bar of the web browser
  • in the title zone of the page (depending on the template used)

lingvo

The language used in the interface of Pâturage.

Provide a language code that conforms to the ISO 639-1 standard. Here is the list of supported languages in version 1.0 of Pâturage:

  • Esperanto (code ‘eo’)
  • English (code ‘en’)
  • French (code ‘fr’)

mysql servilo

MySQL server name.

The default value is ‘localhost’, but your hosting service may provide another name.

mysql uzanto

MySQL user name.

mysql datumbazo

MySQL database name.

mysql pasvorto

The password that corresponds to the provided MySQL user name in order to access the MySQL database.

mysql tabelprefikso

A prefix to add to the names of MySQL tables.

This parameter may be useful if the same database is used by several applications on the server, or if you plan to install several instances of Pâturage on the same server. Provide a prefix that will avoid conflicts between table names.

paturage administra pasvorto

Administrator password for your Pâturage site.

This password will be required for all creation, modification and suppression of Pâturage items.

For security reasons, it is recommended to replace the default value by your chosen password.

paturage uzanta pasvorto

User password for your Pâturage site.

This password will allow your friends to browse the private items of your Pâturage site.

For security reasons, it is recommended to replace the default value by your chosen password.

pado al la dosierdeponejo

Path to the folder that will be used as a file repository for Pâturage.

This parameter must be a relative path from the installation folder of Pâturage to the repository folder. The default value is «deponejo», which means that the folder «deponejo» located in the Pâturage tree will be used.

pado al la chefa dosierujo de paturage

Path to the installation folder of Pâturage.

The default value of this parameter is «paturage», which means that the URL to access your Pâturage site will be of the form: http://www.mysite.com/paturage/.

shablono

Name of the template to use in the interface of Pâturage.

Templates are stored in folder «shablonoj» in the Pâturage tree. Each template corresponds to a subfolder; the name of the template is the same as the name of the subfolder.

minimuma grandeco de etikedoj

Minimum text size for tags, in percents of the default text size.

The interface of Pâturage includes a tag cloud where the size of each tag reflects the number of related items. If a tag is rarely used, it can be displayed too small. To ensure that it will still be readable, this parameter allows you to set a minimum tag size.

maksimuma grandeco de etikedoj

Maximum text size for tags, in percents of the default text size.

The interface of Pâturage includes a tag cloud where the size of each tag reflects the number of related items. If a tag is often used, it can be displayed too big. To ensure that it will not take too much space, this parameter allows you to set a maximum tag size.

largho de bildoj

Maximum image width in image views and slideshows.

alto de bildoj

Maximum image height in image views and slideshows.

largho de miniaturoj

Maximum thumbnail width in galleries.

alto de miniaturoj

Maximum thumbnail height in galleries.

nombro da rang-niveloj

Number of rating levels for items.

nombro da miniaturoj en albumoj

Number of visible thumbnails in galleries.

nombro da artikloj vidigeblaj en foliumilo

Number of visible elements in the main page of Pâturage.

vivdauro de kuketoj

Lifetime of cookies, in seconds.

Cookies are used to maintain the user/administrator connection alive for a given time. The default duration is set to 30 days.

Installation

Copy all files of the Pâturage distribution to the server (your hosting service will generally provide you an FTP access). If the folder to use as a file repository is not the default one (folder «deponejo» provided in the Pâturage tree), you should create that folder yourself and set the appropriate permissions so that PHP may write in it.

Start your internet browser and open a URL of the form:

http://www.mysite.com/paturage/instalu.php

(replace «www.mysite.com» and «paturage» by the appropriate values according to your setup).

The install script will attempt to create the MySQL tables. If the tables were successfully created, you will be invited to start using your Pâturage site immediately.

If the install script displays error messages, this may be caused by incorrect settings in your file «agordoj.php». Correct your parameters and send the new version of this file to the folder named «agordoj» in the Pâturage tree on the server.

 
en/webmasters.txt · Lastaj amendoj: 2007/07/28 15:49 by llumeao
 
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki