Hennes Hervé Développeur Web

Une petite note rapide pour donner et historiser une astuce bien pratique dans le cas ou vous souhaitez faire des modifications sur les fichiers pdfs générés par Prestashop dans l’administration.

Ceci concerne tout ceux qui sont générés  par le controller : controllers/admin/AdminPdfController.php

• Les factures
• Les livraisons
• Commandes fournisseurs

Par défaut le comportement est que le fichier pdf est téléchargé par le navigateur, ce qui devient relativement pénible lorsque les modifications sont assez lourdes.

Pour forcer l’affichage du pdf dans le navigateur il vous suffit de modifier la fonction generatePDF du controller  controllers/admin/AdminPdfController.php et de rajouter l’option « I » dans l’appel à la fonction render

public function generatePDF($object, $template)
    {
        $pdf = new PDF($object, $template, Context::getContext()->smarty);
        $pdf->render('I'); //Changement de code ici
    }

Le contenu du fichier pdf sera ensuite affiché directement dans le navigateur ce qui fera gagner un temps précieux dans la visualisation des modifications pdf 🙂

Cette astuce a été testée sur une 1.7.4 et une 1.7.6 , mais je pense qu’elle doit fonctionner sur l’ensemble des versions 1.7…

Cet article fait partie d’une série d’articles qui présentent les fonctionnalités avancées disponibles dans un controller d’administration Prestashop. ( adminController )
Les exemples sont réalisés dans le cadre d’un module mais s’appliquent également à tous les anciens controllers de l’administration qui n’utilisent pas encore l’infrastructure symfony
Vous pouvez-consulter les autres articles de la série :

• Présentation des informations
• Fonctionnement basique
• Fonctionnalités avancées générales
• Fonctionnalités du listing
• Fonctionnalité des formulaires
• Fonctionnalités des options

Dans cet article nous allons à présent nous intéresser à la gestion des options de notre controller et voir les cas suivants :

• Ensemble des cas d’affichage d’options
• Traitement spécifique d’une option

Les options sont définies dans la fonction __construct() du controller
Voici un code qui génère une grande partie des cas  avec les commentaires explicatifs de leur fonctionnement.

Attention car les valeurs des options seront stockées dans la table globale de configuration de Prestashop.
Pensez donc à bien supprimer ces informations lors de la désinstallation de votre module.…

Cet article fait partie d’une série d’articles qui présentent les fonctionnalités avancées disponibles dans un controller d’administration Prestashop. ( adminController )
Les exemples sont réalisés dans le cadre d’un module mais s’appliquent également à tous les anciens controllers de l’administration qui n’utilisent pas encore l’infrastructure symfony
Vous pouvez-consulter les autres articles de la série :

• Présentation des informations
• Fonctionnement basique
• Fonctionnalités avancées générales
• Fonctionnalités du listing
• Fonctionnalité des formulaires
• Fonctionnalités des options

Cet article est encore d’écriture et présente les informations spécifiques aux formulaires

Informations générales

Les formulaires dans les controllers d’administration sont gérés par la classe HelperForm dont le code complet est visible ici :

https://github.com/PrestaShop/PrestaShop/blob/develop/classes/helper/HelperForm.php

Le rendu est ensuite affiché à partir du template : admin-dir/themes/default/template/helpers/form/form.tpl

Les types de champs possibles

La bonne nouvelle et qu’il existe une page de démonstration de l’ensemble des possibilités de ces champs dans tous les sites prestashop 🙂

Pour y accéder il faut aller dans votre administration et saisir l’adresse :

http://www.votre-site.comt/admin-dir/index.php?controller=…

Cet article fait partie d’une série d’articles qui présentent les fonctionnalités avancées disponibles dans un controller d’administration Prestashop. ( adminController )
Les exemples sont réalisés dans le cadre d’un module mais s’appliquent également à tous les anciens controllers de l’administration qui n’utilisent pas encore l’infrastructure symfony
Vous pouvez-consulter les autres articles de la série :

• Présentation des informations
• Fonctionnement basique
• Fonctionnalités avancées générales
• Fonctionnalités du listing
• Fonctionnalité des formulaires
• Fonctionnalités des options

Cet article détaillera les fonctionnalités suivantes

• Fonctionnement général
• Champs active / non active
• Ajouter un callback sur un champ
• Ajouter des actions de masse personnalisée
• Récupérer les données de plusieurs tables

Fonctionnement général

Les listings dans les controllers admin prestashop sont gérés par le helper « HelperList » qui est disponible dans le dossier classes/helpers/HelperList.php

Pour le fonctionnement basique vous pouvez regarder cet article https://www.h-hennes.fr/blog/2018/11/15/prestashop-admincontroller-pour-un-module/
L’initialisation et l’affichage du la liste sont géré dans la fonction renderList() de la class AdminController

Cet article est en cours d’écriture et présentera les informations spécifiques aux listings…

Cet article fait partie d’une série d’articles qui présentent les fonctionnalités avancées disponibles dans un controller d’administration Prestashop. ( adminController )
Les exemples sont réalisés dans le cadre d’un module mais s’appliquent également à tous les anciens controllers de l’administration qui n’utilisent pas encore l’infrastructure symfony
Vous pouvez-consulter les autres articles de la série :

• Présentation des informations
• Fonctionnement basique
• Fonctionnalités avancées générales
• Fonctionnalités du listing
• Fonctionnalité des formulaires
• Fonctionnalités des options

Cet article présent le plan général du sujet qui est assez vaste.
Il était initialement réparti en 2 articles mais pour clarifier les fonctionnalités j’ai séparé les informations par thématiques.

Voici les sujets qui seront traités, cette série ayant vocation a être assez exhaustive n’hésitez pas à partager vos astuces ou les points manquants

Général :

• Gestion de la toolbar
  • Changement du titre
  • Ajout d’un bouton d’action
• Ajouter une action
• Validation spécifique
• Gestion d’images
• Appels Ajax
• Surcharger le template

Listing :

• Champs active / non active
• Ajouter un callback sur un champ
• Ajouter des actions de masse personnalisée
• Récupérer les données de plusieurs tables

Formulaire :

• Fonctionnement général
• Visualisez l’ensemble des champs disponibles
• Lier des champs en ajax
• Afficher des contenus totalement personnalisé

Options :

• Ensemble des cas d’affichage d’options
• Traitement spécifique d’une option

Pour des raisons techniques j’ai récemment du repasser sous windows pour quelques jours récemment.

En étant habitué la console linux c’est un énorme retour en arrière d’utiliser la console standard de windows  ( cmd ) d’autant quelle ne gère pas nativement la connexion ssh

Mon usage de la console est essentiellement basé autour la connexion à des serveurs web, ou des commandes git sous windows j’utilise le sous-sytème wsl pour gérer toutes ces commandes.

J’utilisais déjà pour remédier à ça l’alternative cmder https://cmder.net/

Qui rendait déjà les choses bien plus pratiques avec sa gestion multi-onglets et le chargement de profils.
Mais  j’avais pas mal de problèmes dans la gestion des flèches lors de l’édition des fichiers avec vim qui me faisait souvent perdre du temps

J’ai donc profiter la sortie officielle de la version 1.0 de terminal et j’ai été assez séduit par son fonctionnement et son utilisation :

• Gestion multi-onglets
• Types de fenêtres ( cmd / powershell / wsl )

Si vous utilisez souvent la console sous windows je pense que c’est un outil que vous adopterez très vite 🙂

Vous pouvez l’installer depuis le lien suivant :
https://www.microsoft.com/fr-fr/p/windows-terminal/9n0dx20hk701?activetab=pivot:overviewtab…

Ça fait un moment que je n’avais pas posté d’information à propos de mon outil de console sur Prestashop, PrestashopConsole ( depuis 2016 exactement 😀 )

A l’occasion de la sortie de la version 1.6,  c’est l’occasion le faire à nouveau pour balayer les nouveautés apportées par cette version, ainsi que l’ensemble des possibilités apportées par la console.

Je précise également que l’outil même si il peut être utilisé via un clone du dépôt github, a surtout vocation a être utilisé via son format phar, qu’il faut déposer à la racine de votre projet.

Voici les nouvelles fonctionnalités de cette version :

A compter de cette version, toutes les futures évolutions seront listées dans la page des releases sur github :

https://github.com/nenes25/prestashop_console/releases…

J’utilise la solution mantis depuis pas mal d’années pour suivre l’ensemble des mes projets personnels, à ce titre j’ai déjà développé quelques plugins spécifiques à mes différents besoins.
 ( La grande majorité sont disponibles sur github ou sur ce blog )

J’ai de plus en plus de plugins qui nécessitent l’exécution de tâches planifiées ( cron ), et à part ajouter manuellement les crons de chaque plugin dans la crontab du serveur je n’ai pas trouvé de solution pratique sur mantis bugtracker pour gérer ces crons.

C’est donc l’occasion de faire un nouveau plugin qui va permettre de simplifier tout cela 😀

Ce plugin nécessite les droits d’administrateur pour pouvoir visualiser et configurer les informations

Principe de fonctionnement

Ce plugin va collecter l’ensemble des tâches planifiées de l’ensemble des autres plugins via un événement personnalisé.
Il ne sera donc nécessaire que d’entrer la page de ce module dans la crontab de votre serveur
Nous verrons dans la dernière partie comment ajouter des tâches planifiées via un plugin.…

Edit 2020-04-05 :
J’ai découvert dans la configuration que cette fonctionnalité existe déjà nativement dans mantis ..
Ce plugin n’est donc pas forcément très utile, une note à retenir toujours lire la documentation avant de développer 😀
Pour activer le fonctionnement natif il suffit de configurer la variable de configuration: g_time_tracking_stopwatch à ON

Pour faciliter le suivi de la gestion de temps avec Mantis bugtracker voici un plugin tout simple,qui permets de connaître le temps réel passé sur le traitement d’un bug.

Celui-ci ajoute des boutons pour gérer un timer dans le formulaire d’ajout d’une note sur un bug comme vous pouvez le voir dans la capture suivante

Il est possible de modifier le timer via les boutons « Start » , « Pause », »Stop », »Reset »

Lors du clic sur le bouton « Stop » le temps passé est automatiquement saisi dans le champ « Suivi du temps »

Attention pour que cela fonctionne il faut bien penser à activer l’option time_tracking_enabled

Pour la gestion du timer j’ai utilisé la librairie  https://github.com/albert-gonzalez/easytimer.js…

J’ai récemment du tester le bon fonctionnement d’une api produit et j’ai un peu galérer à trouver un script fonctionnel pour créer et modifier un produit via l’api Prestashop.

Si d’autres personnes rencontrent le même problème voici des exemples basiques mais fonctionnels de création et de mise à jour de produits via l’api Prestashop

Le code a été testé sur une version 1.7.6 mais devrait fonctionner sur toutes les versions 1.7 , voir même les versions 1.6 vu que l’api a assez peu bougée.

Les exemples utilisent la librairie du webservice prestashop ( cf. https://devdocs.prestashop.com/1.7/development/webservice/tutorials/prestashop-webservice-lib/ )

Pour créer un produit

try {
        //Création d'un produit avec uniquement les champs requis
        $webService = new PrestaShopWebservice($url, $key, $debug);
 
        $xmlResponse = $webService->get(['url' => $url . '/api/products?schema=blank']);
        $productXML = $xmlResponse->product[0]; //Récupération du schéma de création
        $productXML->name->language[0] = "test de produit Langue 1";
        $productXML->name->language[1] = "test de produit FR";
        $productXML->description->language[0] = "test de description langue 1";
        $productXML->description->language[1] = "test de description FR";
        $productXML->price = "1000.000";
        $productXML->id_category_default = 2;
        $productXML->state = 1;//Cette valeur doit être à 1 pour que le produit soit visible dans les listings admin
 
        //On ajoute également dans une catégorie
        //La première catégorie est déjà présente dans le schéma
        $productXML->associations->categories->category[0]->id = 6;
 
        //Si on veut en ajouter d'autres il faut procéder différement en rajoutant des noeuds
        $categoriesNode = $productXML->associations->categories;
        $categoriesNode->addChild('category')->addChild('id',7);
        $categoriesNode->addChild('category')->addChild('id',8);
 
 
        //Envoi des informations au webservice
        $opt = ['resource' => 'products'];
        $opt['postXml'] = $xmlResponse->asXML();
        $return = $webService->add($opt);
        $id = $return->product->id;
        echo "Création du produit $id <br />";
 
    } catch ( PrestaShopWebserviceException $e){
        echo $e->getMessage();
    }