Installation et mise à jour de MetaModels

MetaModels doit être installé sur une version LTS (long time support) de Contao : - la version actuelle est Contao 3.5.x

Installation à l’aide de Composer

MetaModels et ses dépendances peuvent être installés via le “gestionnaire de paquet Composer <https://c-c-a.org/ueber-composer>”

Si votre installation de Contao utilise déjà le nouveau gestionnaire de paquets Composer, vous pouvez sélectionner et installer MetaModels facilement en tapant son nom dans le champs de recherche comme suit : * metamodels/bundle_all

La version actuelle du bundle est la « 2.0.x » qui installera l’ensemble des éléments autour de « MetaModels core ». Le menu de restriction vous permet de choisir entre différentes versions comme « bugfix release », « feature release » etc. « Feature release » active l’ensemble des fonctions de MetaModels.

Si vous n’avez pas besoin de tous les filtres et/ou des attributs, vous pouvez les installer séparément. Vous pouvez aussi sélectionner un autre Bundle. Les paquets mentionnés regroupent les éléments nécessaires à certains besoins.

Vous pouvez voir les paquets déjà installés en affichant le graphe des dépendances (case à cocher) du client Composer de Contao (« Package management »).

Installation via Nightly build

L’alternative à Composer est d’installer MetaModels par FTP. Pour cela, vous devez télécharger la version la plus récente depuis le site du projet http://now.metamodel.me/ Dézippez-le et envoyez-le par FTP sur votre serveur. La plupart des dossiers doivent être placés dans le dossier /system/module - seuls deux fichiers PHP qui gèrent les fonctions Ajax doivent être placés à la racine du dossier Contao.

Ensuite, vous mettrez à jour la base de données par le « gestionnaire d’extensions ». Si vous obtenez le message : Fatal error: Class 'MetaModels\Helper\UpgradeHandler' ....!metamodels-tng-branch/config/runonce_0.php vous devez purger le cache interne. Cette option se trouve dans le menu « Maintenance » du backend de Contao.

Test de paquets spécifiques à l’aide de Composer

Le bundle « bundle_all » contient tous les paquets à jour disponibles pour MetaModels. Il peut y avoir des paquets supplémentaires avec des correctifs de bugs ou de nouvelles fonctions à tester. Par exemple, pour MetaModels core, il peut s’agir de « dev-hotfix-xyz ». Vous pouvez trouver ces paquets sur Github dans le dépôt correspondant (ex MetaModels/core) sous les onglets de “branches” <https://github.com/MetaModels/core/branches>`_.

Pour tester un paquet, vous devez le sélectionner et l’installer séparément par le gestionnaire de paquets. Pour cela, cochez la case « dépendances installées » puis cliquez sur le paquet correspondant (ex : “metamodels/core”). Enfin, dans le menu déroulant, choisissez par exemple “dev-hotfix-xyz”.

Après avoir cliqué sur « Mark package to install » vous devez modifier le fichier Composer-JSON. Pour cela, dans Package manager, cliquez sur « settings » puis « expert mode ». Le fichier JSON est affiché. Il faut ajouter « as 2.0.0 » à l’entrée concernée sous le nœud « require ». Si vous souhaitez installer plusieurs paquets spécifiques, vous devez le faire pour chacun d’entre eux.

Exemple :
"metamodels/core": "dev-hotfix-xyz" à modifier
"metamodels/core": "dev-hotfix-xyz as 2.0.0"

Après l’installation via « update packages », cliquez sur « Clear Composer cache » dans l’onglet « settings » du gestionnaire de paquets.

Comme MetaModels est étroitement lié à DC_general (DCG) vous devrez régulièrement le mettre à jour aussi vers une version plus récente pour pouvoir effectuer vos tests. C’est la même procédure que pour MetaModels, y compris pour la modification de l’entrée correspondante dans le fichier JSON avec « as 2.0.0 ».

Pour revenir à la version initiale, supprimez simplement le paquet par le gestionnaire de paquets.

N’oubliez pas que vos retours de test sont précieux pour l’équipe de développement. N’hésitez pas à les faire sur Github.

Mettre à jour MetaModels

Si vous avez installé MetaModels via Composer, vous devez l’utiliser aussi pour effectuer les mises à jours.

Si vous avez installé MetaModels manuellement, vous devez prendre en compte certains points.

La procédure suivante s’est révélée la plus efficace :

  • supprimez TOUS les anciens dossiers MetaModel (vous pouvez vérifier en comparant avec le précédent téléchargement) - vraiment TOUS
  • Supprimez le cache de Contao -> /system/cache (tout ce qui est dans ce dossier)
  • NE FAITES SURTOUT PAS de mise à jour de la base de données (database update) sous peine de perdre toutes vos données
  • téléchargez la dernière nightly build, dézippez les fichiers et téléversez les (par FTP)
  • mettez à jour la base par /contao/install.php

Vous trouverez les dernières informations sur le forum

Basculez MetaModels de la version « Nighty build » à la version « Composer »

La procédure est similaire à celle pour « mettre à jour MetaModels ». Si vous basculez sur Composer, prenez en compte que c’est une application très gourmande en mémoire. Par expérience, il vous faudra au moins 100 Mo. La taille mémoire exacte requise dépend des autres paquets installés ainsi que de la configuration du serveur chez votre hébergeur.

La procédure suivante s’est révélée la plus efficace :

  • installez Composer
  • supprimez TOUS les anciens dossiers de MetaModel (vous pouvez vérifier en comparant avec le précédent téléchargement) - vraiment TOUS
  • Supprimez le cache de Contao -> /system/cache (tout ce qui est dans ce dossier)
  • NE FAITES SURTOUT PAS de mise à jour de la base de données (database update) sous peine de perdre toutes vos données
  • dans Composer, sélectionnez la version de MetaModels voulue, « Mark package to install » puis lancez l’installation
  • la mise à jour de la base de données doit vous être automatiquement proposée: acceptez.

Vous trouverez les dernières informations sur le forum .