Aller au contenu

[RBS Cooking] Création d’un projet vierge pour les nuls

  • par

Déployer un pack [[http://www.rbschange.fr/addons/distributions/RBS-Change-complet-Open-Source,67203.html|RBS Change complet]] comprenant le thème //Default//, l’ensemble des modules open-source, des pages et du contenu fictifs.

===== Méthode de déploiement =====

**1.** Sous SSH, rendez-vous à la racine du répertoire dans lequel vous avez l’habitude de déployer vos projets et débuter par un **cook update** :

cook update

**2.** Créez le nouveau projet :

cook create_new_project:,

(exemple: **cook create_new_project:aubert,3.6.4**)

Si aucune version de Framework n’est spécifiée dans la commande, c’est la version la plus récente qui sera installée.

**3.** Dans un éditeur de code, ouvrir le fichier //change.xml// du projet que vous venez de déployer et commenter les modules qui commencent par « wf ». Exemple :


<!--module source="wfgit@wf.ssxbgit01.intra.rbs-fr.net:repo/module.wf.git">wf-4.0.0</module-->

**4.** Toujours dans le fichier //change.xml//, ajouter la liste des modules à installer. Une liste à jour est disponible sous git dans le fichier //change.xml// du projet [[http://wf.ssxbgit01.intra.rbs-fr.net/gitweb/?p=project.demo.git;a=summary|Demo]].

**5.** Sous SSH, se rendre à la racine du nouveau projet et lancer la commande **ch create-new-project** (où **ch** est un alias de la commande change) :

ch create-new-project

**6.** Si des erreurs interviennent lorsque le script exécute la commande **rebuildFiles** :

ch gdb ; ch ca ; ch richtext.rebuild-files

**7.** Dans le fichier //change.xml//, dé-commenter les modules qui commencent par « wf ».

**8.** Faire un theme.install :
* du thème //Default// :

cook e:local c.install_theme

* du thème de votre choix :

cook e:local c.install_theme:,branch=master

**9.** Si pas encore installé, installer le module sample :

ch install-module sample-3.6.4 (ou autre version, suivant la version de Change que vous venez de déployer)

Cette commande vaut pour installer n’importe quel module supplémentaire.

**10.** Déployer les pages et le contenu fictif (cette commande peut être lancée à chaque fois qu’un nouveau module est installé – **Attention : pour déployer le contenu fictif, il faut __obligatoirement__ avoir installé le thème Default.**) :

ch sample.import full-os

**11.** (optionnel) Exécuter les commandes suivantes :

ch compile-all ; ch clear-all

**12.** Pour les e-commerces (notamment ceux avec facettes, qui ne font pas partie du pack open-source) :

ch catalog.compile-catalog ; ch indexer reset

**13.** Ne pas oublier d’ajouter votre nouveau site dans votre //host//.

===== Troubleshooting =====

=== Si la connexion en admin est impossible ===

ch reset-database

=== Si le site s’affiche mal (pas de css, problème d’url) ===
**1.** Vérifier le contenu du fichier //profile// se trouvant à la racine du site. Par exemple :


intlangf

**2.** Se rendre à la racine du répertoire //config// de votre projet.

**3.** Repérer le fichier //project..xml//. Dans notre exemple : project.intlangf.xml.

**4.** Vérifier dans ce fichier que l’url vers votre projet est correcte.


<entry name="server-fqdn">url_de_mon_projet</entry>

===== Installer le module wfslider =====

**1.** Dans change.xml (toujours, pour les nouveaux déploiements) :

wfslider-1.0

**2.** Pour téléchargement depuis git quand projet déjà déployé :

git clone ssh://wfgit@wf.ssxbgit01.intra.rbs-fr.net/home/wfgit/repo/module.wfslider.git repository/modules/wfslider/wfslider-1.0

**3.**

php framework/bin/change.php install-module wfslider-1.0