.: NOTICE D'INSTALLATION :.

BLOGATOR-SCRIPT 1.01

Ce manuel se base sur un serveur Linux, mais Blogator Script peut s'installer et a été testé sur serveur Windows (sous réserve de modifications mineures, en cas de problème(s)).

1) Configuration requise :





2) Notes de performance :

Blogator-script est hautement personnalisable. En fonction des capacités et de la configuration de votre serveur ou de votre hébergement, il convient de définir des paramètres cohérents. En effet la génération de fichiers images par PHP consiste en des fonctions assez gourmandes en utilisation CPU et RAM. De plus la configuration de PHP doit permettre ce paramètrage. Les valeurs par défaut de Blogator-Script ont été testées sur un serveur puissant mais tout dépend de la fréquentation de votre plateforme de blog. Il s'agit donc d'ajuster selon la fréquentation du site, la puissance du serveur (si serveur dédié) et vos convenances. Attention si vous consommez trop de ressources sur un hébergement gratuit ou mutualisé vous risquez de voir votre compte suspendu ou transféré, prudence !




3) Configuration de PHP :

Sur serveur dédié >> Il s'agit du fichier php.ini. Le fichier "phpinfo.php" inclus vous donne son emplacement. En général dans /usr/local

Voici la configuration nécessaire pour les paramètres PAR DEFAUT du script :

upload_max_filesize = 10M (défaut 2M - php.ini ou .htaccess)
--> correspond à la Taille max. d'un fichier multimédia dans install.php

post_max_size = 18M (défaut 8M - depuis PHP 4.0.3, php.ini seulement pour PHP <= 4.2.3)
--> correspond à la taille max totale d'un article
Pour la calculer : (Taille max. des photos x Nb de photo(s) / article) + Taille max. d'un fichier multimédia + marge de sécurité
Ex : (1,5 Mo par photo x 5 photos par article) + 10 Mo de fichier multimédia + 0,5 Mo pour le reste = 18 Mo
Soit (1,5 x 5) + 10 + 0,5 = 18

Les paramètres suivants sont conseillés pour des serveurs assez puissants (CPU + RAM), sinon laissez par défaut...
memory_limit = 16M (défaut 8M - php.ini ou .htaccess)
max_execution_time = 60 (défaut 30 - php.ini ou .htaccess)
max_input_time = 90 (défaut -1 - depuis PHP 4.3.0, php.ini ou .htaccess)

Sur tout serveur l'autorisant (configuration d'Apache) >>
Vous pouvez également appliquer ces paramètres localement via un fichier .htaccess, à placer à la racine du script. Attention vérifiez plus haut si la variable de configuration est modifiable via .htaccess (si la version de PHP est >= à 4.3 aucun problème ne devrait se poser). 
php_flag upload_max_filesize 10
php_flag post_max_size 18
php_flag memory_limit 16M
php_flag max_execution_time 60
php_flag max_input_time 90

Un modèle de fichier htaccess est présent avec le script dans 'Fichiers supplémentaires du script\configuration php - htaccess'

Il est vivement conseillé d'avoir la Directive "register_globals" à Off dans le php.ini (vous pouvez vérifier cette variable de configuration via le fichier "/phpinfo.php" fourni; renommez-le ou supprimez-le afin d'éviter que quelqu'un y accède pour vérifier votre configuration...).



4) PROCÉDURE D'INSTALLATION :

- A l'aide d'un éditeur texte ou html ouvrir la page "pass_cfg.php" située à la racine du script. A la ligne 4 renseigner un mot de passe administrateur (très important pour la sécurité globale !)

- Copier le contenu du dossier "Blogator-script" à l'endroit où le script doit être installé. C'est à cet endroit que votre plateforme sera accessible et que les blogs seront générés (un dossier par blog), sauf en mode sous-domaine ou les blogs sont stockés dans le sous-domaine de votre choix. Veuillez vérifier que php a bien les droits d'écriture dans ce dossier.

- Il est parfois nécessaire de mettre un chmod 777 (ou dumoins donner le droit d'écriture à php) pour le fichier modele.php dans /_blogadata.

- A l'aide d'un éditeur texte ou html ouvrir la page "pass_cfg.php" située à la racine du script. A la ligne 4 renseigner un mot de passe administrateur (très important pour la sécurité globale !)

- Ouvrir "bs_auth.php" à l'aide d'un navigateur Internet et se connecter via le mot de passe préalablement choisi

- Personnaliser ensuite les paramètres du script (par défaut, certains paramètres sont pré-renseignés)

- Vérifier que vous avez renseigné tous les champs

- Valider votre paramètrage en cliquant sur "Installer"

La plateforme de blogs Blogator-script est désormais prête à l'emploi ! Vous êtes redirigé dessus à l'issue de l'installation.

Note : Pensez à renommer le fichier "/phpinfo.php" pour plus de sécurité

REMARQUE :
En mode normal : les blogs sont accessibles depuis le dossier où se situe le script suivi du nom du blog
Ex 1.1: http://www.monsite.com/blogs/nom_blog/
Ex 1.2: http://www.monsite.com/nom_blog/
En mode sous-domaine : les blogs sont accessibles depuis l'adresse du sous-domaine par le biais de 2 adresses
Ex 2.1 : http://sousdomaine.monsite.com/nom_blog/
Ex 2.2 : http://nom_blog.monsite.com/

Attention ! si vous souhaitez que les blogs soit accessibles tel que dans l'exemple 1.2, il faudra installer Blogator-script à la racine. Cela implique de vérifier que vous n'allez pas écraser certains fichiers déjà présents sur votre site et portant le même nom (comme index.php).



5) OPTION SOUS-DOMAINE (Blogs accessibles via sous-domaines) :

Rendre disponible cette fonctionnalité implique une bonne connaissance du serveur sur lequel vous travaillez. De même vous devez disposer d'un serveur dédié pour effectuer les opérations de manipulation des fichiers de configuration.

Voici les étapes nécessaires à la mise en place effective de l'option sous-domaine.

- mettre en place un sous-domaine sur votre site en ajoutant de préférence directement un VirtualHost dans le fichier httpd.conf situé souvent dans /usr/local/apache/conf 

DocumentRoot /home/mon_site/mon_sd
ServerName mon_sd.mon_site.tld
ServerAlias *.mon_site.tld
Le principal est d'avoir un ServerAlias utilisant un wildcard (*), vous pouvez configurer le reste à votre guise.

- Créer le dossier correspondant au sous-domaine

- Situer le fichier .hosts (/var/bind/pri) et ajouter la ligne wildcard (plus celle du sous-domaine si créé manuellement) de type : 
mon_sd          IN      A       [adresse_ip]
*               IN      A       [adresse_ip]
- Ouvrir le fichier 'index.php' situé dans 'Fichiers supplémentaires du script\sous-domaine - index.php' et renseigner la variable $adr_sd avec l'adresse du sous-domaine (celle que vous avez donné lors de l'installation).

- Placer le fichier index.php dans votre dossier de sous-domaine

- La dernière opération consiste à ouvrir le fichier 'fckconfig.js' situé dans '\_blogadata\editeur'. A la ligne 184 (fin du fichier), remplacer 'http://127.0.0.1' par l'URL du site (pas celle du script si différente).
FCKConfig.SmileyPath = 'http://127.0.0.1' + FCKConfig.BasePath + 'images/smiley/msn/' ;

FIN

Plus d'infos et support sur http://www.blogator-script.com