VQMOD : ça marche comment, en français ?

[Django29]

Bonjour

Nouvel adepte d'Opencart, j'ai lu qu'un certain VQMOD était indispensable.

Je l'ai donc installé, avec VQmod manager. Pas de message d'erreur.

Maintenant, j'en fais quoi ?

J'ai cru comprendre que c'était un outil pour faire de l'override comme je fais souvent dans Joomla.
Est-ce bien çà ?

[lucho69]

essaie d'installer un module gratuit VQMOD et regarde comme le fichier xml est créé, tu comprendras vite :
ordre search qui recherche une chaine dans un php , tpl , js
ordre replace ou before ou after pour modifier ou insérer tes modifs

guide en français, je sais pas trop, le wiki est anglais

[Django29]

Merci lucho69. Je vais tester.
J'avais l'impression que c'était un bidule de geek.

[Django29]

Bonjour.

Finalement, c'est bien un truc de programmeur fait et commenté pour les programmeurs ... dont je ne fais pas partie.
(En créant des sites web, mon objectif n'est pas de prouver que je suis un programmeur de haut niveau, mais que les produits et l'entreprise présentés sont excellents, et que le visiteur devrait donc passer commande.)

Une fois uploadé un module VQmod, il apparait bien dans l'admin VQmod. Après, je fais quoi ? Mystère.

J'ai essayé de comprendre un tutoriel français sur la bête : c'est du codage de scripts pur et dur.

Personnellement j'ai besoin d'une interface graphique pour travailler. Je ne tripote le code que quand c'est absolument nécessaire (modifs CSS en général).

[lucho69]

tout à fait , vqmod est pour les développeurs, son but est de protéger le coeur du système avec des modifs de scripts qui sont programmés par xml et permettront de faire évoluer les versions de opencart sans perdre ses modifs

mais ça reste technique

[Django29]

C'est ce qu'on appelle l'override dans Joomla, mais, en général, j'essaie de limiter ces modifs au CSS, rarement aux autres types de fichiers.

[lucho69]

vqmod te permet de modifier css / tpl et php

[Django29]

Oui, mais il me semble nécessiter un bac+5 en programmation.

[lucho69]

je pense pas , mon développeur l'a , mais moi j'ai un petit Bac+2
pour un css , pas la peine d'utiliser chmod
mais c'est simple :

toujours commencer par :

Code: Tout sélectionner

<modification>
   <id>Le nom de ta modif</id>
   <version> la version de ta modif </version>
   <vqmver>1.1.0 (la version minimum que tu imposes </vqmver>
   <author> ton nom </author>

ensuite, tu définis le fichier à modifier

Code: Tout sélectionner

<file path="répertoire où se trouve ton fichier, exemple /catalog/view/theme/default/stylesheet " name="nom du fichier à modifier, exemple stylesheet.css">

ensuite tu dis à quelle ligne tu veux ta modif , pour un ajout tu définis avant / après la recherche
par exemple, avant l'ordre #container { tu veux insérer ton propre code : tu mettras entre crochet dans CDATA la ligne complète avant laquelle tu mettras ton code

Code: Tout sélectionner

<operation>
         <search position="before"><![CDATA[ copier toute la ligne de code ]]></search>

after, si tu veux insérer après
replace si tu veux remplacer, dans ce cas, bien copier TOUT, exactement comme s'est, espace et saut inclus

ta modif se met comme cela , que ce soit after, before ou replace

<add><![CDATA[

ton code !!!

]]></add>

et tu termines par </operation>
tu peux faire plusieurs modifs dans le même fichier, tu répètes alors <operation> ... </operation>
et tu termines les modifs de ce fichier par </file>

si tu veux modifier d'autres fichiers, tu recommences un autre <file> .... </file>
et tu termines ton fichier par : </modification>

exemple d'un xml que je propose gracieusement : rajouter un champ textuel sur les fiches produits avant le prix (par exemple un texte comme "livraison offerte pour ce produit"
L'idée est d'utiliser un champ existant qui ne sert pas beaucoup : location

intro du xml : *

Code: Tout sélectionner

<modification>
   <id>Product Additional text before Price</id>
   <version>1.0</version>
   <vqmver>2.2.0</vqmver>
   <author>presencepme.com</author>
   <!-- For OC 1.5.1 - 1.5.4 -->

modif dans product.php pour que l'on récupère le champ de la base : product_info(location)

Code: Tout sélectionner

   <file name="catalog/controller/product/product.php">
      <operation>
      <search position="after" ><![CDATA[
         $this->data['model'] = $product_info['model'];
      ]]></search>
      <add><![CDATA[
         $this->data['location'] = $product_info['location'];
      ]]></add>
      </operation>   
   </file>

pour clarifier, j'ai rajouté après la récup du champ "model" , le champ non utilisé "location"
ensuite je veux le faire affiché, en rouge, en gras avant le prix (j'aurais pu être puriste et rendre paramétrable la couleur, mais bon ...)
donc affichage nouveau champ dans product.tpl :
<file name="catalog/view/theme/*/template/product/product.tpl">
<operation>
<search position="before" ><![CDATA[<?php if ($price) { ?>]]></search>
<add>
<![CDATA[
<span style="font-weight:bold; color:#ff0000;"><?php echo $location; ?></span>
]]>
</add>
</operation>
</file>
et je termine par </modification>
en étant puriste, j'aurais pu modifier le texte langue FR "localisation" en admin pour avoir par exemple

fichier langue \admin\language\french\catalog\product.php


faire un replace de
$_['entry_location'] = 'Localisation :';
par
$_['entry_location'] = 'Texte additionnel Prix<br />(frais port offert, etc ... :';

mais je l'ai fait "en dur"

c'est pour cela que je te proposais de prendre un xml existant et de jouer avec, tu verras qu'en pratiquant, tu obtiens ton bac+5 VQmod en peu de temps

[lucho69]

bien sur ce xml , tu le copies dans /vqmod/xml/
dans ce répertoire, une modif active est : ******.xml
une modif désactivée est ******.xml_ (le underscore est là pour ne plus avoir l'extension xml

dans ton admin, modules / vqmod Manager tu verras ton module créé:
File Name Version VQMod Version Author Status
product_additional_text_price.xml 1.0 2.2.0 presencepme.com Enabled / Disabled

bien surveiller les 1ers temps que le xml est correct, si non, il va remplir le fichier Error Log, que tu peux vérifier dans un onglet de Vqmod Manager (récentes versions) ou dans l'onglet unique
le error log te dira par exemple : file not found : erreur sur le nom du fichier, les répertoires (typique pour un fichier langue , si tu veux modifier ton site en Français, il faut pas laisser /en/ dans les répertoires !!!
autre erreur fréquente : search not found : le texte de recherche n'est pas trouvé dans le fichier à modifier

SEARCH NOT FOUND (ABORTING MOD): $this->data['text_missing'] = $this->language->get('text_missing');

[Django29]

Merci lucho69 d'avoir pris le temps de m'expliquer tout çà en détail, même si, à la première lecture, j'ai l'impression d'être un aveugle guidé à la voix pour se déplacer dans une zone très accidentée qu'il ne connait pas.

Je vais tout de même essayer de comprendre tes explications, mais seulement quand j'en aurai vraiment besoin dans un de mes sites en construction.
De toutes façons, je me doute que ces infos seront utiles à d'autres non-programmeurs, et aussi aux programmeurs qui découvrent Opencart.