Développer des modules personnalisés pour Magento

Le développement de modules personnalisés Magento est un élément essentiel de tout développement ou projet Magento, car à tout moment, vous souhaiterez peut-être intégrer vos propres fonctionnalités/modules dans un projet Magento existant.

Dans cette série, je couvrirai les détails du développement de modules personnalisés Magento.

Si vous souhaitez développer davantage Magento, consultez les différentes extensions Magento utiles sur Envato Market.

Dans cette série, je fais référence à Magento Community Edition 1.7, bien qu'il s'agisse d'une version personnalisée La structure du module est la même dans toutes les versions de Magento. Avant de commencer le développement proprement dit du module, comprenons rapidement la structure de base de Magento.

Chaque fois que vous installez un nouveau Magento, vous remarquerez la structure de répertoires Magento suivante :

Introduction à la structure Magento MVC

Comme tout autre framework majeur comme Joomla, CakePHP, CodeIgniter, etc., Magento suit également une architecture basée sur MVC, bien que celle-ci soit légèrement différente de l'architecture de base PHP MVC. Ici, je vais expliquer les différences dans l'architecture Magento en la comparant avec une simple architecture PHP MVC.

Architecture PHP MVC

Dans un modèle MVC typique, le flux d'une application ressemble à ceci :

1. Il existe un point d'entrée principal - index.php - à partir duquel l'ensemble du mécanisme de routage des applications est déterminé.
2. Sur la base de ce mécanisme de routage et du modèle d'URL demandé, l'application appellera le contrôleur approprié.
3. Le contrôleur appelle ensuite la vue appropriée.
4. Enfin, le fichier de vue collecte les données du fichier modèle et affiche les données.

Architecture Magento MVC

L'architecture MVC de Magento ajoute quelques couches au modèle MVC, mais le flux de contrôle de base de l'application est le suivant :

1. Il existe un point d'entrée principal - index.php - à partir duquel l'ensemble de l'application sera initialisé.
2. Le contrôleur approprié sera appelé en fonction de l'URL demandée.
3. Les contrôleurs définissent les pages et chargent les fichiers de mise en page pour ces pages.
4. Le fichier de mise en page indique au contrôleur quels fichiers de bloc utiliser.
5. Les fichiers de bloc collectent les données des fichiers de modèle et d'assistance et les transmettent aux fichiers de modèle.
6. Le fichier modèle reçoit les données et restitue le code HTML.

Au départ, cela peut être difficile à comprendre car il contient des couches supplémentaires. Pour vous familiariser davantage avec le flux de contrôle, développons un module "Hello World" personnalisé.

Avant de commencer à utiliser le module

• Je suppose que vous disposez déjà d'une copie de travail de Magento avec la version 1.7 ou 1.7+ (sinon la version n'a pas d'importance à ce stade)
• Désactivez la mise en cache. Pour désactiver la mise en cache, accédez au Panneau d'administration Magento > Système > Gestion du cache > Sélectionnez tous les types de cache dans la case de gauche > Sélectionnez Action : Désactiver dans la liste déroulante en haut à droite > Cliquez sur Soumettre.

Structure des modules Magento

Base de codes

Magento contient trois types de pools de codes où résident tous les modules personnalisés et principaux de Magento.

1. Core Pool contient tous les modules de base fournis par défaut avec l'installation de Magento. Ces modules sont écrits par des développeurs Magento. Il est recommandé de ne pas modifier ces modules car chaque fois que vous mettez à niveau votre installation Magento, tous les modules principaux seront écrasés et vos modifications seront perdues.
2. Le Community Pool contient tous les modules (c'est-à-dire les modules personnalisés) développés par des programmeurs tiers et installés via Magento Connect. Ces modules étendent généralement les modules de base et fournissent leurs propres fonctionnalités, qui peuvent généralement être utilisées n'importe où dans Magento.
3. Le pool local contient tous les modules personnalisés qui seront utilisés dans un projet spécifique mais ne seront pas lus dans Magento Connect

Nous avons donc deux options de piscine : piscine communautaire ou piscine locale. Puisque nous développons notre propre projet, nous utiliserons une piscine locale, bien qu'il n'y ait aucune restriction quant à l'utilisation d'une piscine communautaire.

Structure

Le module Magento se compose des composants suivants :

• Blockscontient des fonctions pour afficher les données dans des modèles.
• Modelcontient la logique métier du module.
• Modèle de ressourceContient des fonctions pour l'interaction avec la base de données.
• Contrôleur Définissez la mise en page, bloquez les fichiers et chargez-les lorsqu'une URL est demandée.
• etcContient un fichier de configuration au format XML qui indique à Magento le nombre de fichiers du module et comment le module interagit.
• AideContient des fonctions permettant de définir une logique métier commune (par exemple, redimensionnement d'image, validation). Ces fonctions peuvent être utilisées n'importe où dans l'application Magento
• sqlContient des scripts SQL pour créer, modifier ou supprimer des tables SQL.

Nom des modules

Nous devons donner un nom à notre module. De manière générale, les noms de modules Magento se composent de deux parties : _<module>. La meilleure pratique pour nommer vos modules Magento est de choisir <code class="inline"><namespace></namespace> 作为作者或公司名称，并选择 <module></module> comme nom d'auteur ou de société et

Suite à ces conventions de dénomination, j'ai donné à notre module le nom Chiragdodia_Mymodule. Nous ferons référence à ce nom tout au long de cette série.

Installation et configuration du code

Créons un répertoire basé sur la structure ci-dessus. Accédez au répertoire d'installation de Magento, accédez à app/code/local et créez un répertoire comme indiqué ci-dessous.

Ensuite, nous allons créer le fichier de configuration Chiragdodia_Mymodule.xml pour configurer et activer notre module. app/etc/modules 目录中创建配置文件 Chiragdodia_Mymodule.xmlCe répertoire contient les fichiers de configuration pour tous les modules.

<?xml version="1.0"?>
<config>
    <modules>
        <Chiragdodia_Mymodule>
        <active>true</active>
        <codePool>local</codePool>
        </Chiragdodia_Mymodule>
    </modules>
</config>

pour activer notre module. Si tout est correct jusqu'à présent, vous trouverez votre module dans la liste active 标签中，我们指定了 truePanneau d'administration Magento > Système > Configuration > Avancé > Avancé > Désactiver la sortie du module . De là, vous pouvez activer et désactiver votre module.

app/code/local/Chiragdodia/Mymodule/etc  并创建一个 config.xml et créez un config.xml < /i> Un fichier qui contiendra le contenu suivant

<?xml version="1.0"?>
<config>
    <modules>
        <Chiragdodia_Mymodule>
            <version>0.1.0</version>    <!-- Version number of your module -->
        </Chiragdodia_Mymodule>
    </modules>
    <frontend>
        <routers>
            <mymodule>
                <use>standard</use>
                <args>
                    <module>Chiragdodia_Mymodule</module>
                    <frontName>mymodule</frontName>
                </args>
            </mymodule>
        </routers>
    </frontend>
</config>

Dans la balise <mymodule>, nous définissons le nom du module i><mymodule> 标签中，我们在 <module> < 中定义了模块名称i><frontName> 中的标签和前端名称。通过使用前端名称，我们可以在前端访问我们的模块，例如 yoursitename.com/index.php/mymodule/index<frontName> balise et le nom du frontend dans . Nous pouvons accéder à notre module sur le frontend en utilisant le nom du frontend, par exemple yoursitename.com/index.php/mymodule/index.

En appelant yoursitename.com/index.php/mymodule 或 yoursitename.com/index.php/mymodule/index Magento recherchera le fichier d'action d'index du contrôleur de module. Par conséquent, nous devons créer le fichier contrôleur.

Allez dans app/code/local/Chiragdodia/Mymodule/controllersapp/code/local/Chiragdodia/Mymodule/controllers  并创建文件 IndexController.php et créez le fichier IndexController.php

<?php
class Chiragdodia_Mymodule_IndexController extends Mage_Core_Controller_Front_Action
{
    public function indexAction()
    {
        echo "Hello tuts+ World";
    }
}

Ici, nous étendons la classe Mage_Core_Controller_Front_Action ，其中包含在URL路由中使用的所有方法。 Magento 类名反映了类文件的位置。因此，类 Mage_Core_Controller_Front_ActionMage_Core_Controller_Front_Action , qui contient toutes les méthodes utilisées dans le routage d'URL. Les noms de classe Magento reflètent l'emplacement des fichiers de classe. Par conséquent, la classe Mage_Core_Controller_Front_Action se trouve dans

Chiragdodia_Mymodule_IndexController。 Magento 控制器的命名方式应反映 (<module>tag)_(Action Controllername)(keyword Controller).

• Cette balise est définie dans <module>Chiragdodia_Mymodule（我们已在 config.xmltag = )
• 控制器名称
Opération
• = Index Controller
Contrôleur d'action suivi de

<?php
class Chiragdodia_Mymodule_IndexController extends Mage_Core_Controller_Front_Action
{
    public function indexAction()
    {
        echo "Hello tuts+ World";
    }
    public function testAction()
    {
        echo "test action";
    }
}