admin controller | Hervé Hennes

Prestashop : Utilisation avancée des AdminController – Les options

8 juin 2020 / herve / Prestashop

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 :

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.…

Prestashop : Utilisation avancée des AdminController – Les options Lire la suite »

Pas de commentaires

Prestashop : utilisation avancée des AdminController – Les formulaires

8 juin 2020 / herve / Prestashop

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=…

Prestashop : utilisation avancée des AdminController – Les formulaires Lire la suite »

2 commentaires

Prestashop : utilisation avancée des AdminController – Les listings

8 juin 2020 / herve / Prestashop

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…

Prestashop : utilisation avancée des AdminController – Les listings Lire la suite »

Pas de commentaires

Prestashop : Créer un controller admin pour un module : Présentation des options avancées

8 juin 2020 / herve / Prestashop

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

…

Prestashop : Créer un controller admin pour un module : Présentation des options avancées Lire la suite »

Pas de commentaires

Prestashop 1.7 Identifier si un controller admin a été migré vers symfony

25 juillet 2019 / herve / Prestashop

Un petit article rapide qui fait suite aux nombreux retours que j’ai dans les commentaires de certains de mes tutoriels liés à l’administration de Prestashop.

Un des objectifs principal de cette version est de migrer l’ensemble de l’administration vers le framework symfony, au fur et à mesure des nouvelles versions le nombre de page migrées sera donc de plus en plus important.

Et par ricochet mes anciens articles ne seront plus applicables.

Le moyen le plus simple pour vérifier si le controller est migré vers symfony et de consulter son url.

Les anciennes urls ( non symfony ) sont sous la forme

https://prestashop-site.com/admin-dev/index.php?controller=AdminAddresses&

Le terme « controller » est présent dans l’url.

Visuellement les listings se présentent de cette manière :

Les nouvelles urls (avec symfony ) sont sous la forme

https://prestashop-site.com/admin-dev/index.php/sell/customers/

Le terme « controller » n’est pas présent dans l’url.

Visuellement les listings se présentent de cette manière

Ces éléments devraient être suffisant pour vous permettre d’identifier dans quel type de controller admin vous vous trouvez 🙂

…

Prestashop 1.7 Identifier si un controller admin a été migré vers symfony Lire la suite »

2 commentaires

Prestashop : Utilisation avancée des AdminController

30 janvier 2019 / herve / Prestashop

Cet article présente les modifications « générales » qui peuvent être réalisées dans un controller d’administration.

Les points suivants seront traités :

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

Général :

Gestion de la toolbar :

Ajouter un titre sur la page

Ce point est géré par la fonction initToolbarTitle

    /**
     * Affichage d'un titre personnalisé
     */
    public function initToolbarTitle()
    {
        parent::initToolbarTitle();
 
        switch ($this->display) {
            case '':
            case 'list': //Titre pour le listing
                array_pop($this->toolbar_title);
                $this->toolbar_title[] = $this->module->l('Custom Title for listing');
                break;
            case 'add': //Titre pour l'ajout et l'édition d'un objet
            case 'edit':
                array_pop($this->toolbar_title);
                if (($sample = $this->loadObject(true)) && Validate::isLoadedObject($sample)) {
                    $this->toolbar_title[] = sprintf($this->module->l('Editing sample %s'),$sample->name);
                } else {
                    $this->toolbar_title[] = $this->module->l('Creating a new sample');
                }
                break;
        }
    }

Ajouter un bouton d’action :
Cet élément est géré par la fonction initPageHeaderToolbar

public function initPageHeaderToolbar()
    {
 
        //Bouton d'ajout ( standard )
        $this->page_header_toolbar_btn['new'] = array(
            'href' => self::$currentIndex .

…

Prestashop : Utilisation avancée des AdminController Lire la suite »

6 commentaires

Prestashop : créer un admin controller pour un module

15 novembre 2018 / herve / Prestashop

Nous allons voir les différentes étapes pour réaliser facilement un controller admin basique lié à un module Prestashop.
Puis nous verrons ensuite les caractéristiques de base d’un controller admin, cet article sera complété par d’autres articles pour voir les fonctionnalités avancées 😉
Vous pouvez consulter l’ensemble des informations sur cette page : https://www.h-hennes.fr/blog/2019/01/30/prestashop-utilisation-avancee-admincontroller/

Note : A partir de la version 1.7.5 de Prestashop il est possible d’utiliser d’utiliser le framework symfony et de suivre le même fonctionnement que les nouveaux controller admin de prestashop, je ferais sans doute un article ultérieurement.
Ce tutoriel reste tout de même valide sur cette version et les suivantes pour l’instant.

Pour cela nous allons créer un module « samplemodule ».
Le code complet est visible sur github : https://github.com/nenes25/prestashop_samplemodule/tree/admin

Les prérequis suivants sont nécessaires pour réaliser un controller admin pour votre module :

Création d’une « Tab »
Utilisation d’un objet Prestashop héritant de la classe ObjectModel ( et de la base de données qui lui est associée )

Pour l’objet Prestashop nous partirons sur un objet fictif « Sample » avec les propriétés suivantes :

name : nom de l’objet
code : code de l’objet
email : email de l’objet
title : titre de l’objet ( différent en fonction de la langue )
description : description de l’objet ( différent en fonction de la langue )

Le code suivant sera dans le fichier classes/Sample.php…

Prestashop : créer un admin controller pour un module Lire la suite »

23 commentaires