Connexion S'inscrire

Connectez-vous

Login *
Mot de passe *
Se souvenir de moi

Créer un compte

Les champs marqués d'un astérisque (*) sont requis.
Nom *
Login *
Mot de passe *
Vérification mot de passe *
Email *
Vérification email *
Captcha *

Création d'un composant Joomla (partie 26) Création d'un fichier zip d'installation


Dans cette partie,  nous allons créer un fichier d'installation de notre composant. Il y aura une suite à cette série de tutoriels qui portera sur des concepts plus avancés dans la création d'un composant Joomla. Si vous êtes arrivés directement sur cette page, peut-être que vous aimeriez commencer par le début: Partie 1 | Partie 2 | Partie 3 | Partie 4 | Partie 5 | Partie 6 | Partie 7 | Partie 8 | Partie 9 | Partie 10 | Partie 11 | Partie 12 | Partie 13 | Partie 14 | Partie 15 | Partie 16 | Partie 17 | Partie 18 | Partie 19 | Partie 20 | Partie 21 | Partie 22 | Partie 23 | Partie 24 | Partie 25

1 - Mise à jour du fichier SQL d'installation

Nous avons rajouté au cours du développement de notre composant des champs qui n'étaient pas dans notre table au départ. Nous devons donc ajouter tous ces champs dans notre fichier install.mysql.sql avant de créer le fichier d'installation. Nous effacerons le bloc d'insertion de guitaristes qui étais là juste pour aider au développement du composant. Nous ajouterons une catégorie "Non Catégorisé" dans la table des catégories pour avoir une catégorie de base. Le fichier sql se trouve dans le dossier administrator/components/com_djguitariste/sql. Après les modifications, le contenu du fichier devrait ressembler à ceci:

/**
Creation de la table des guitaristes
**/
CREATE TABLE IF NOT EXISTS `#__djguitariste_items` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(250) NOT NULL DEFAULT '',
  `picture` varchar(250) NOT NULL DEFAULT '',
  `intro` mediumtext NOT NULL,
  `biography` text NOT NULL,
  `youtube_video` varchar(255) NOT NULL DEFAULT '',
  `website` varchar(255) NOT NULL DEFAULT '',
  `facebook` varchar(255) NOT NULL DEFAULT '',
  `alias` varchar(255) NOT NULL,
  `metadesc` varchar(1024) DEFAULT NULL,
  `metakey` varchar(1024) DEFAULT NULL,
  `catid` int(10) unsigned NOT NULL DEFAULT '0',
  `ordering` int(11) NOT NULL DEFAULT '0',
  `created_by` int(10) unsigned NOT NULL DEFAULT '0',
  `created_by_alias` varchar(255) NOT NULL,
  `created` datetime NOT NULL DEFAULT '0000-00-00 00:00:00',
  `publish_up` datetime NOT NULL DEFAULT '0000-00-00 00:00:00',
  `publish_down` datetime NOT NULL DEFAULT '0000-00-00 00:00:00',
  `modified` datetime NOT NULL DEFAULT '0000-00-00 00:00:00',
  `modified_by` int(10) unsigned NOT NULL DEFAULT '0',
  `checked_out` int(10) unsigned NOT NULL DEFAULT '0',
  `checked_out_time` datetime NOT NULL DEFAULT '0000-00-00 00:00:00',
  `state` tinyint(2) unsigned NOT NULL DEFAULT '0',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=utf8;

/*Insertion dans la table des catégories*/
INSERT INTO `#__categories` (`path`, `extension`, `title`, `alias`, `published`) VALUES ('non-categorise', 'com_djguitariste', 'Non Catégorisé', 'non-categorise', '1');

2 - Structure

Voici les étapes à suivre :

- Sur le bureau ou un emplacement de votre choix, créez un dossier nommé com_djguitariste (le nom de ce dossier est un choix personnel, vous pouvez lui donner un autre nom si vous voulez).

- À l'intérieur de ce dossier, créez 3 sous-dossiers nommés "admin", "site" et "languages".

- Copier tout le contenu du dossier du composant en administration (tout ce qui se trouve dans administrator/components/com_djguitariste) dans le dossier admin.

- Copiez tout le contenu du dossier du composant côté client (depuis la racine de votre site Joomla components/com_djguitariste) dans le dossier site.

- Dans le dossier languages, créez un dossier nommé admin et un dossier nommé site. Copiez les fichiers de langue en administration dans le dossier admin et copiez le fichier de langue côté client dans site. Les fichiers de langues en administration sont fr-FR.com_djguitariste.sys.ini et fr-FR.com_djguitariste.ini et ils devraient se dans administrator/language/fr-FR. Le fichier de langue du côté client est le fichier fr-FR.com_djguitariste.ini qui se trouve dans language/fr-FR

 

3 mise à jour du fichier manifest d'installation

Le fichier manifest d'installation est le fichier djguitariste.xml qui se trouve dans le dossier admin. C'est dans ce fichier que sont définis tous les fichiers et dossiers à charger pour notre composant. Pour la suite, nous allons le sortir du dossier admin. La structure devrait ressembler à ceci:

Nous avons rajouté de nouveaux fichiers et dossiers au cours du développement qui ne sont pas définis dans le fichier manifest donc nous allons l'ouvrir et rajouter ces modifications. Au final, le contenu ce fichier va ressembler à ceci:

<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.0" method="upgrade">
    <name>com_djguitariste</name>
    <author>Docteur Joomla</author>
    <creationDate>December 2016</creationDate>
    <license>GNU General Public License version 2 or later; see LICENSE.txt</license>
    <authorEmail>Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser.</authorEmail>
    <authorUrl>www.docteurjoomla.com</authorUrl>
    <version>1.0</version>
    <description>COM_DJGUITARISTE_XML_DESCRIPTION</description>
    
    <install>
      <sql>
        <file driver="mysql" charset="utf8">sql/install.mysql.sql</file>
      </sql>
    </install>
    <uninstall>
      <sql>
        <file driver="mysql" charset="utf8">sql/uninstall.mysql.sql</file>
      </sql>
    </uninstall>
    
    <files folder="site">
		<folder>views</folder>
		<folder>models</folder>
        <filename>djguitariste.php</filename>
        <filename>controller.php</filename>
        <filename>index.html</filename>
    </files>
    
    <languages folder="languages/site">
      <language tag="fr-FR">fr-FR.com_djguitariste.ini</language>
    </languages>
    
    <administration>
        <menu>COM_DJGUITARISTE</menu>
        <submenu>
			<menu view="guitaristes" link="option=com_djguitariste&view=guitaristes">COM_DJGUITARISTE_GUITARISTES</menu>
			<menu link="option=com_categories&extension=com_djguitariste">JCATEGORIES</menu>
        </submenu>
        
        <files folder="admin">
			      <filename>access.xml</filename>
            <filenam>config.xml</filenam>
            <filename>controller.php</filename>
			      <filename>djguitariste.php</filename>
            <filename>index.html</filename>           
            <folder>controllers</folder>
            <folder>helpers</folder>
            <folder>models</folder>
			      <folder>sql</folder>
            <folder>tables</folder>
            <folder>views</folder>
        </files>
        
        <languages folder="languages/admin">
          <language tag="fr-FR">fr-FR.com_djguitariste.ini</language>
          <language tag="fr-FR">fr-FR.com_djguitariste.sys.ini</language>
        </languages>
        
    </administration>
</extension>

Compressez le dossier en faisant clique droit, envoyer vers dossier compresser ou en utilisant un logiciel comme WinRar ou WinZip... Le lien télécharger le composant est plus bas sur cette page.

Voilà, vous venez de finir la première partie de la série de tutoriels sur la création d'un composant Joomla. La suite sur les concepts avancées démarrera très prochainement. Restez connectez à notre compte Facebook ou abonnez-vous en bas de cette page pour en être informer.

Lire la suite... 


  • Dernière modification le jeudi, 21 décembre 2017 15:36
  • 330
Docteur Joomla

Après plus de 10 ans d'expérience en Joomla, je lance ce Blog pour partager mes connaissances avec les autres développeurs Joomla.