Minimalteck.fr

Howto install Prestashop

Minimalteck — 2009-11-12T17:25:57Z

Pour mémoire rapide, l'installation de Prestashop sous LAMP (ici la v1.2.5.0, dernière release stable).

Sommaire

Prestashop™ est un logiciel e-commerce Open-Source reposant sur php5 et smarty… Moins puissant mais aussi moins complexe que Magento, il est beaucoup plus léger et répondra certainement à la plupart des attentes pour développer une boutique en ligne, alors pourquoi pas…

ÉTAPE 1 : RÉCUPÉRATION DES SOURCES ET ADJUSTEMENT DES DROITS

root@machine:/var/www# wget http://www.prestashop.com/download/prestashop_1.2.5.0.zip
 root@machine:/var/www# unzip prestashop_1.2.5.0.zip
 root@machine:/var/www# chown -R web_user:web_user prestashop
 root@machine:/var/www# cd prestashop
 root@machine:/var/www/prestashop# chown web_user:www-data config/ tools/smarty/compile sitemap.xml
 root@machine:/var/www/prestashop# chown -R web_user:www-data img mails modules themes/prestashop/lang translations upload download
 root@machine:/var/www/prestashop# find ./ -group www-data -type f -exec chmod 664 {} \;
 root@machine:/var/www/prestashop# find ./ -group www-data -type d -exec chmod 775 {} \;

ÉTAPE 2 : CRÉATION DE LA BASE DE DONNÉES

root@machine:/var/www/prestashop# mysql -u root -p
 mysql> CREATE DATABASE `prestashop` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
 CREATE USER 'prestashop'@'localhost' IDENTIFIED BY 'prestapass';
 GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON `prestashop` . * TO 'prestashop'@'localhost';
 FLUSH PRIVILEGES;

ÉTAPE 3 : INSTALLATION VIA LE WEB

Ensuite via le Web : http://machine.domaine.tld/prestashop/install/

ÉTAPE 4 : FINALISATION

root@machine:/var/www/prestashop# rm -rf install/
 root@machine:/var/www/prestashop# mv admin gestion

L'espace d'admin se trouve à l'url : http://machine.domaine.tld/prestashop/gestion

Liens utiles

Prestashop sur wikipedia
Communauté francophone de Prestashop
Liste de modules gratuits
Forum PrestaShop
La documentation

ADD-ON : Module SIPS/ATOS

L'installation de ce module vendu par la prestateam ne pose pas de souci particulier, il suffit de suivre les instructions du fichier INSTALL.txt…
En revanche je vous invite à revoir les permissions à apposer sur les différents fichiers de ce module une fois installé.

root@machine:/var/www/prestashop# chmod 755 ./modules/atos
 root@machine:/var/www/prestashop# find ./modules/atos/ -type f -exec chmod 644 {} \;
 root@machine:/var/www/prestashop# chmod 664 ./modules/atos/parmcom.XXXXXXXXXXXXXXX ./modules/atos/pathfile ./modules/atos/fr.php ./modules/atos/en.php
 root@machine:/var/www/prestashop# chmod 770 ./modules/atos/bin/*

"XXXXXXXXXXXXXXX" est le numéro de marchand Atos qui vous a été transmis.

HOWTO : Migration SPIP

Minimalteck — 2009-08-17T15:42:37Z

Sommaire

Ce HOWTO décrit une procédure de migration d'un site Web sous SPIP [1]/LAMP [2].
Il se destine "aux admins sys débutants" ou "aux admins sys qui connaissent rien à SPIP et qui pensent qu'ils vont galérer grave"… bref c'est de la migration à consommer sans mâcher…

Les préliminaires Quelques vérifications sont à faire pour ne pas avoir de mauvaises surprises…

Au niveau d'Apache2 :

Vérifier qu'Apache dispose du mod_rewrite :
root@linux:~# ls /etc/apache2/mods-enabled/ | grep rewrite rewrite.load

le module est bien chargé, sinon pour l'activer "a2enmod rewrite ;/etc/ini.d/apache2 force-reload" fera l'affaire

Consulter la configuration vhost [3] du site spip à migrer : La directive AllowOverride placée à All pour disposer des .htaccess

Au niveau de Spip : vérifier la compatibilité des plugins installés, des squelettes, etc.
Là c'est pour les puristes… normalement cette tâche est dévolue aux développeurs…

Ça c'est fait, maintenant, on va vraiment s'y mettre…

ETAPE 1 : Installation d'une nouvelle version de Spip

Créer un nouveau répertoire temporaire sous l'arborescence de l'actuel site spip ex : spip-x.x.x (où x.x.x correspond à la nouvelle version) cela permettra d'accédér à l'interface Web d'installation sans pour autant toucher à la configuration d'Apache pour le moment
root@linux:~# cd /chemin/vers/spip/ancienne/version/ root@linux:/chemin/vers/spip/ancienne/version# mkdir spip-x.x.x root@linux:/chemin/vers/spip/ancienne/version# cd spip-x.x.x

Récupérer et déployer l'archive de la version stable de SPIP (on trouvera l'url à partir de http://www.spip.net/fr_download) :
> On télécharge ; on dézippe ; on replace les fichiers contenus dans le nouveau répertoire "spip" vers ./spip-x.x.x ; on supprime l'archive et le répertoire "spip" vide.
root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# wget http://files.spip.org/spip/stable/spip.zip ; unzip ./spip.zip ; mv ./spip/* . ; rm -rf ./spip/ ./spip.zip;

Modifier les droits des répertoires local/ tmp/ config/ pour la nouvelle installation : on affecte les droits au bon propriétaire:groupe (ici webuser:webuser) pour l'ensemble des fichiers du site
root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# chown -R webuser:webuser ./*

Mais on doit autoriser Apache à lire/ecrire dans IMG/ local/ tmp/ config/ donc :

root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# chown -R :www-data IMG/ local/ tmp/ config/
 root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# chmod 775 IMG/ local/ tmp/ config/

ETAPE 2 : Couper les accès à l'ancien site

on va creer un message de maintance aux internautes via un fichier index.html que l'on place au sein de l'ancien site :
root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x#echo 'Site en maintenance' > ../index.html

on va tester la présence d'un .htaccess utilisé par les réecritures d'URL dans spip. S'il existe, on le copie sous le répertoire ./spip-x.x.x/ et on met une nouvelle règle qui va rediriger tout vers index.html
root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# test ! -f .htaccess || cp -a ../.htaccess .; printf "RewriteEngine On\nRewriteBase /\nRewriteRule (.*) index.html [L]" > ../.htaccess;

On corrige tout de suite la directive RewriteBase de l'ancien .htaccess en ajoutant /spip-x.x.x/
root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# sed -i -e 's/^$RewriteBase$$.*$\/$/\1\2\/spip-x.x.x\//g' .htaccess

Copier les répertoire IMG, squelettes-dist (ou celui correspondant aux squelettes utilisés par le site) et le répertoire plugins s'il existe de l'ancienne version spip vers la nouvelle instance : root@linux :/chemin/vers/spip/ancienne/version/# cp -ar ../IMG ../squelettes-dist ../plugins .

ETAPE 3 - Aspect MySQL

Récupérer les paramètres de connexion au sgdb sont dans l'arborescence spip sous /config/connect.php
root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# grep spip_connect_db ../config/connect.php spip_connect_db('host',','user','password','db_name','mysql', 'spip',');

faire un dump de la base utilisée par spip :
root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# mysql -u root -p --opt db_name > ../db_name.backup.sql

Créer une nouvelle base qui accueillera la nouvelle version de spip
root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# mysql -u root -p mysql> USE db_name2 ; //on vérifie que la nouvelle base n'existe pas : si c'est le cas, mysql nous renvoie une erreur mysql> CREATE DATABASE `db_name2` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; // création de la nouvelle base en utf8 mysql> GRANT SELECT , INSERT , UPDATE , DELETE , CREATE , DROP , INDEX , ALTER , CREATE TEMPORARY TABLES , CREATE VIEW , SHOW VIEW , CREATE ROUTINE, ALTER ROUTINE, EXECUTE ON `db_name2` . * TO 'user'@'host' ; // affectation des droits à l'utilisateur user sur la nouvelle base mysql> FLUSH PRIVILEGES ; // on recharge les privilèges mysql> EXIT;

Alimentation de la nouvelle base avec la sauvegarde
root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# mysql -u root -p db_name2 < ../db_name.backup.sql

ETAPE 4 - Installation de la nouvelle version via l'interface Web

Dans un navigateur ouvrir http://url.ancien.site/spip-x.x.x/e… et procéder à l'installation avec les choix suivants :

ETAPE 1 : Connexion à votre base de données
- Adresse de la base de données : host
- Le login de connexion : user
- Le mot de passe de connexion : password
ETAPE 2 : Choix de votre base
- Choisissez votre base : choisir db_name2
ETAPE 3 : Informations personnelles Attention : cela va écraser les anciens paramètres de l'administrateur principal du site… il vaut mieux donc les remettre à l'identique, ou penser à signaler ces changements à la personne qui maintient le site.
- Votre identité publique : Signature/Votre adresse email
- Vos identifiants de connexion : Votre login/Votre mot de passe

Finir l'installation et effectuer les derniers réglages :

Se connecter à l'interface privée : Un message technique peut apparaître proposant une procédure de mise à jour, en fait une mise à niveau de la base base SQL Il suffit alors de suivre instruction indiquées
Aller dans "Configuration > Vider le cache" : vider le cache
Si le site comporte de splugins, aller dans "Configuration > Gestion des plugins" activer les plugins requis en cochant les cases associées et cliquer sur "Valider"

ETAPE 5 : Vérification du bon fonctionnement du site

Dans l'espace privé, aller dans Configuration et ajouter "spip-x.x.x/" à l'"Adresse (URL) du site public"
Un rapide surf sur le site permettra de voir si la migration s'est bien passée… j'en suis sûr

ETAPE 6 : mise en production

Aller dans "Configuration > Vider le cache" : vider le cache
Corriger le .htaccess en supprimant le "spip-x.x.x\/" du RewriteBase

root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x#sed -i -e 's/spip-x.x.x\///g' .htaccess

On se replace en racine du Vhost pour sauvegarder l'ancien site au cas où et on nettoyer tout :

root@linux:/chemin/vers/spip/ancienne/version/spip-x.x.x# cd ..

on sauvegarde :
root@linux:/chemin/vers/spip/ancienne/version# tar -cpzf ~/backup.tar.gz --exclude=spip-x.x.x *

on nettoye bien :
root@linux:/chemin/vers/spip/ancienne/version# find ./ -maxdepth 1 -type d ! -name "spip-x.x.x" -exec rm -rf {} \; root@linux:/chemin/vers/spip/ancienne/version# find ./ -maxdepth 1 -type f ! -name ".htaccess" -exec rm -rf {} \;

on met en prod en déplaçant le contenu de ./spip-x.x.x en racine du Vhost :

root@linux:/chemin/vers/spip/ancienne/version# mv ./spip-x.x.x/* .

on supprime le répertoire qui a servi à la migration, l'ancienne base de données et c'est fini !!!!

root@linux:/chemin/vers/spip/ancienne/version# rmdir ./spip-x.x.x
 root@linux:/chemin/vers/spip/ancienne/version# mysql -u root -p
 mysql> REVOKE ALL PRIVILEGES ON `db_name` . * FROM 'user'@'localhost';
 mysql> mysql> FLUSH PRIVILEGES ;
 mysql> DROP// DATABASE `db_name` ;
 mysql> EXIT;

La procédure en elle-même est identique sous Windows… mais on clique plus qu'on ne tapote et on ne se préoccupe pas des permissions sur les fichiers…

[1] Note : concerne les version ultérieures à spip 1.9.1

[2] Dans l'exemple une Debian-like

[3] Remarque : Quel est le fichier de conf pour ce site ? un "grep -l '/chemin/vers/spip/ancienne/version/' /etc/apache2/sites-available/*" donne la réponse !

Plugin SPIP : diaporama avec jQuery

Minimalteck — 2009-08-17T11:26:32Z

Sommaire

Présentation du plugin Spip jQuery Cycle :

" sjcycle " est un diaporama paramétrable pour Spip basé sur la librairie javascript jQuery et les plugins :

Développé pour Spip [2.0.x] il utilise :

les formulaires CVT ;
le moteur de configuration CFG [1.10] ;
les modèles pour une insertion aisée dans le texte des articles.

- Fonctionnalités principales :

Paramétrage des effets, de la vitesse de transition, de la taille du diaporama, etc.
Possibilté d'afficher plusieurs diaporama au sein d'un même article
Possibilté de sélectionner les images à associer à chaque diaporama

Décryptage de la syntaxe et paramètres du raccourci typographique "sjcycle"

Le raccourci typographique "sjcycle" permet d'insérer facilement un ou plusieurs diaporamas au sein d'un article : il vous suffit de le recopier à l'intérieur de la case « Texte » de l'article, là vous désirez situer le diaporama.

Ce raccourci comporte jusqu'à 3 paramètres, ordonnés et séparés par le caractère "|".

Premier paramètre, "N", obligatoire :
Correspond au numéro de l'article en cours.
Il permet de cibler les images liées à un unique article.
Astuce : Vous pouvez ainsi insérer un diaporama avec les images d'un article dans un autre article.
Second paramètre, "|ALIGN", optionnel :
Permet de spécifier l'alignement du diaporama au sein du texte.
S'il n'est pas précisé, l'alignement est "center".
Les options de l'alignement :
1. "left" : à gauche du texte ;
2. "center" : centrer dans le texte ;
3. "right" : à droite du texte.
Troisième paramètre, "|docs=n1,n2,[…],nx", optionnel :
Permet de spécifier la liste d'images à afficher dans le diaporama.
Ainsi, on peut afficher plusieurs diaporamas dans au sein d'un même texte, isoler des images.
S'il n'est pas précisé, l'ensemble des images sont sélectionnées par défaut.
Les arguments de sélection "n1,n2,[…],nx" du paramètre "|docs=" :
Ils se composent d'une suite de numéros d'images séparées par des virgules sans espace.
Sous chaque image est indiqué un raccourci typographique du type "", "" ou "", où "XX" désigne le numéro de l'image correspondante.
Ainsi le paramètre "|docs=1,3", sélectionne les images numéro 1 et 3 de l'article courant.
Astuce : Vous pouvez utiliser le raccourci en ne passant qu'un seul numéro d'image au paramètre "|docs=" afin de bénéficier de l'effet "FancyBox" : un clic sur l'image redimensionnée du diaporama permet d'afficher l'image originale en superposition.

Ce qu'il faudrait faire…

Intégrer plus d'options du jQuery Cycle Plugin ;

Créer la fonction d'install du plugin pour installer les paramètres par défaut lors de l'activation du plugin et surtout nettoyer les "metas" lors de sa désactivation… J'ai rencontré un problème lors de cette mise en place :

 if (!defined("_ECRIRE_INC_VERSION")) return;
 function sjcycle_install($action){
 include_spip('sjcycle_fonctions');
 switch ($action){
 case 'test':
 //Contrôle du plugin à chaque chargement de la page d'administration
 // doit retourner true si le plugin est proprement installé et à jour, false sinon
 if(!lire_config('sjcycle')){
 return true;
 } else {
 return false;
 }
 break;
 case 'install':
 //Appel de la fonction d'installation. Lors du clic sur l'icône depuis le panel.
 //quand le plugin est activé et test retourne false
 if(!lire_config('sjcycle')){
 ecrire_config('sjcycle',serialize(init_sjcycle_default('default_value_list')));
 }
 break;
 case 'uninstall':
 //Appel de la fonction de suppression
 //quand l'utilisateur clique sur "supprimer tout" (disponible si test retourne true)
 effacer_config('sjcycle');
 return true;
 break;
 } 
 }
 ?>

le code me semblait pourtant correct, mais à chaque fois que le cas 'test' (affichage de la gestion des plugin, le système écrasait les valeur par celles par défaut…
Même en passant par lire_meta() en lieu et place de la version fournie par CFG… je n'ai pas plus creusé que ça… c'est sûrement tout bête !

compacter les css ;

etc.

Pour conclure

Ce plugin s'adresse avant tout aux personnes désireuses d'agrémenter leur site SPIP de diaporamas légers mais performants, avec un descriptif de l'image en survol, un affichage en superposition.

Actuellement taggé en "test", ce plugin est cependant totalement fonctionnel et est utilisé sur des sites en production.

Démonstration

Une première séries d'images…

Et voici lz seconde, avec titres et descriptifs…

Ez-Publish : sauvegarde

Minimalteck — 2009-04-22T11:36:18Z

Sommaire

Étape 1 : Vider les caches :

Pour vider les caches d'Ez-Publish, rien de plus simple :

se placer dans répertoire d'installation de l'instance d'Ez-Publish
exécuter en ligne de commande (nécessite php cli)
server:/var/www/ez/# php bin/php/ezcache.php --clear-all Clearing : Cache d'affichage de contenu, Cache Global INI, Cache INI, Cache codepage, Expiry cache, Cache des identifiants de classes, Cache des clés de classement, Cache des alias d'URL, Cacher de transformation des caractères, Alias d'image, Cache des templates, Cache des template block, Cache des templates override, Cache RSS, Cache de informations personnelles des utilisateurs

alternativement vous pouvez utiliser un script shell disponible pour les versions antérieures à la 3.10 [1]
server:/var/www/ez/# sh bin/shell/clearcache.sh --clear-all Removing cache files in var/cache/content Removing ini cache files in var/cache/ini Removing codepage cache files in var/cache/codepages Removing template cache files in var/cache/template Removing template override cache files in var/cache/override Removing template-block cache files in var/cache/template-block Removing translation cache files in var/cache/translation Removing translation cache files in var/cache/wildcard Removing sortkey cache files in var/cache/sortkey_ Removing user-info cache files in var/cache/user-info Removing class identifier cache files in var/cache/classidentifiers_ Removing class attribute identifier cache files in var/cache/classattributeidentifiers_

Étape 2 : Sauvegarder la base

Si vous êtes étourdi, sachez que vous pouvez rapidement retrouver les informations « DatabaseSettings » dans le fichier « settings/override/site.ini.append.php » [2].
Faire un dump de la base :

mysqldump -u userez -p --opt ezbase | gzip -9 > ezbase.`date +%d-%m-%Y`.sql.gz

Étape 3 : Sauvegarder le tout

Il ne reste plus qu'à archiver l'arborescence de notre instance d'Ez-Publish

server:/var/www/# tar cfz backup_ez.tar.gz ez

et hop… l'affaire est dans le sac

[1] Quelle version est installée ? La réponse est là : server:/var/www/ez/# more kernel/ezinfo/about.php

[2] Pour mémoire le fichier « settings/override/site.ini.append.php » contient également d'autres paramètres de configurations intéressants comme les « MailSettings », le nom et l'URL du site « SiteSettings », mais aussi ceux concernant les caches via les blocks de configuration « FileSettings », « ContentSettings », « OverrideSettings », « TemplateSettings ».

Plugin Pages uniques et squelette par défaut

Minimalteck — 2009-04-07T15:04:55Z

La structure d'un site sous SPIP est construite sur une hiérarchie de rubriques. Le Plugin Pages uniques permet de créer des articles hors de cette hierarchie, des pages uniques ou orphelines.

Les articles générés par ce très utile plugin ont "id_rubrique" affecté à "-1".
Partant de ce postulat, il est aisé de fournir un squelette par défaut à ce type de page, simplement en créant un fichier article--1.html dans le répertoire des squelettes.
Pour les explications, je vous renvoie à la doc SPIP : Les variantes de squelette

EzPublish : Reset du "password_hash" admin

Minimalteck — 2008-11-27T10:17:24Z

Vous avez oubliez le mot de passe de l'admin sous votre site Ez ?
Ne pleurez plus amis poissons rouges, voici la recette adéquate…

Sous mysql (en console ou sous PhpMyAdmin), requêtez comme suit :

SET @key = 'VotreNouveauMotDePasse';
 SET @username = 'admin';
 SET @del = '\n';
 SET @hash = MD5(CONCAT(@username,@del,@key));
 UPDATE ezuser SET password_hash=@hash WHERE login=@username;

Sous Linux, et si vous aimez vous compliquer la vie, une autre alternative s'offre à vous :
Générez votre nouvelle clé "password_hash" en mode console :

$ echo -n -e "admin\nVotreNouveauMotDePasse" | md5sum

Il ne reste plus qu'à insérer dans mysql la nouvelle clé…

UPDATE `ezuser` SET `password_hash`='2cfe50db7795f6a52f0f03322ba51a1a' WHERE login='admin';

Vous noterez que cela n'a aucun intérêt… ça prend un peu plus de temps, c'est tout

Minimalteck.fr

Howto install Prestashop

ÉTAPE 1 : RÉCUPÉRATION DES SOURCES ET ADJUSTEMENT DES DROITS

ÉTAPE 2 : CRÉATION DE LA BASE DE DONNÉES

ÉTAPE 3 : INSTALLATION VIA LE WEB

ÉTAPE 4 : FINALISATION

Liens utiles

ADD-ON : Module SIPS/ATOS

HOWTO : Migration SPIP

ETAPE 1 : Installation d'une nouvelle version de Spip

ETAPE 2 : Couper les accès à l'ancien site

ETAPE 3 - Aspect MySQL

ETAPE 4 - Installation de la nouvelle version via l'interface Web

ETAPE 5 : Vérification du bon fonctionnement du site

ETAPE 6 : mise en production

Plugin SPIP : diaporama avec jQuery

Présentation du plugin Spip jQuery Cycle :

Décryptage de la syntaxe et paramètres du raccourci typographique "sjcycle"

Ce qu'il faudrait faire…

Pour conclure

Démonstration

Roulage à Carole

Départ...

Retour au stand

Ez-Publish : sauvegarde

Étape 1 : Vider les caches :

Étape 2 : Sauvegarder la base

Étape 3 : Sauvegarder le tout

Plugin Pages uniques et squelette par défaut

EzPublish : Reset du "password_hash" admin