Joomla! Documentation - User contributions [en]

J3.x:Developing an MVC Component/Using the database/fr

2015-07-22T09:11:52Z

Perete: Created page with "Pour le moment, nous avons utilisé un type de champ codé dans le dur pour les messages..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

'''Remarque importante :''' Lorsque le composant est installé, les fichiers du dossier des mises à jour SQL (par exemple, ''admin/sql/updates/mysql'') sont lus et le nom du dernier fichier, dans l'ordre alphabétique, est utilisé pour ajouter le numéro de version du composant à la table <code>#__schemas</code>. Cette valeur doit être présente dans ce tableau afin que la mise à jour automatique puisse exécuter la mise à jour des fichiers SQL pour les futures versions. C'est pourquoi il est judicieux de créer un fichier de mise à jour SQL pour chaque version (même s'il est vide ou ne comporte qu'un commentaire). Ainsi, la version <code>#__schemas</code> correspondra toujours à la version du composant.

'''Remarque importante :''' Lors de l'enregistrement des fichiers SQL en utf8, assurez-vous de bien les enregistrer en utf8 SANS BOM, sinon la requête échouera avec l'erreur MySQL #1064.

Voici le fichier d'installation. Il sera exécuté si vous respectez un ordre approprié dans votre fichier <tt>helloworld.xml</tt>.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/uninstall.mysql.utf8.sql</tt> contenant:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
Pour le moment, nous avons utilisé un [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part| type de champ codé dans le dur pour les messages]]. Nous devons utiliser notre base de données pour choisir le message.

Modifier le fichier <tt>site/views/helloworld/tmpl/default.xml</tt> et ajouter ces lignes

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

Il introduit un nouveau type de champ et demande à Joomla de rechercher la définition de ce champ dans le dossier <tt>/administrator/components/com_helloworld/models/fields de</tt>.

A l'aide de votre gestionnaire de fichiers et éditeur préférés, ajoutez un fichier ''site/models/helloworld.php'' contenant :

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

Le nouveau type de champ affiche une liste déroulante des messages à choisir. Vous pouvez voir le résultat de ce changement dans le gestionnaire de menu de la section helloworld.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/14/fr

2015-07-22T09:11:52Z

Perete: Created page with "Pour le moment, nous avons utilisé un type de champ codé dans le dur pour les messages..."

Pour le moment, nous avons utilisé un [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part| type de champ codé dans le dur pour les messages]]. Nous devons utiliser notre base de données pour choisir le message.

J3.x:Developing an MVC Component/Using the database/fr

2015-07-22T09:08:50Z

Perete:

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

'''Remarque importante :''' Lorsque le composant est installé, les fichiers du dossier des mises à jour SQL (par exemple, ''admin/sql/updates/mysql'') sont lus et le nom du dernier fichier, dans l'ordre alphabétique, est utilisé pour ajouter le numéro de version du composant à la table <code>#__schemas</code>. Cette valeur doit être présente dans ce tableau afin que la mise à jour automatique puisse exécuter la mise à jour des fichiers SQL pour les futures versions. C'est pourquoi il est judicieux de créer un fichier de mise à jour SQL pour chaque version (même s'il est vide ou ne comporte qu'un commentaire). Ainsi, la version <code>#__schemas</code> correspondra toujours à la version du composant.

'''Remarque importante :''' Lors de l'enregistrement des fichiers SQL en utf8, assurez-vous de bien les enregistrer en utf8 SANS BOM, sinon la requête échouera avec l'erreur MySQL #1064.

Voici le fichier d'installation. Il sera exécuté si vous respectez un ordre approprié dans votre fichier <tt>helloworld.xml</tt>.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/uninstall.mysql.utf8.sql</tt> contenant:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modifier le fichier <tt>site/views/helloworld/tmpl/default.xml</tt> et ajouter ces lignes

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

Il introduit un nouveau type de champ et demande à Joomla de rechercher la définition de ce champ dans le dossier <tt>/administrator/components/com_helloworld/models/fields de</tt>.

A l'aide de votre gestionnaire de fichiers et éditeur préférés, ajoutez un fichier ''site/models/helloworld.php'' contenant :

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

Le nouveau type de champ affiche une liste déroulante des messages à choisir. Vous pouvez voir le résultat de ce changement dans le gestionnaire de menu de la section helloworld.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/18/fr

2015-07-22T09:08:49Z

Perete:

Le nouveau type de champ affiche une liste déroulante des messages à choisir. Vous pouvez voir le résultat de ce changement dans le gestionnaire de menu de la section helloworld.

J3.x:Developing an MVC Component/Using the database/fr

2015-07-22T09:03:34Z

Perete: Created page with "A l'aide de votre gestionnaire de fichiers et éditeur préférés, ajoutez un fichier ''site/models/helloworld.php'' contenant :"

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

'''Remarque importante :''' Lorsque le composant est installé, les fichiers du dossier des mises à jour SQL (par exemple, ''admin/sql/updates/mysql'') sont lus et le nom du dernier fichier, dans l'ordre alphabétique, est utilisé pour ajouter le numéro de version du composant à la table <code>#__schemas</code>. Cette valeur doit être présente dans ce tableau afin que la mise à jour automatique puisse exécuter la mise à jour des fichiers SQL pour les futures versions. C'est pourquoi il est judicieux de créer un fichier de mise à jour SQL pour chaque version (même s'il est vide ou ne comporte qu'un commentaire). Ainsi, la version <code>#__schemas</code> correspondra toujours à la version du composant.

'''Remarque importante :''' Lors de l'enregistrement des fichiers SQL en utf8, assurez-vous de bien les enregistrer en utf8 SANS BOM, sinon la requête échouera avec l'erreur MySQL #1064.

Voici le fichier d'installation. Il sera exécuté si vous respectez un ordre approprié dans votre fichier <tt>helloworld.xml</tt>.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/uninstall.mysql.utf8.sql</tt> contenant:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modifier le fichier <tt>site/views/helloworld/tmpl/default.xml</tt> et ajouter ces lignes

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

Il introduit un nouveau type de champ et demande à Joomla de rechercher la définition de ce champ dans le dossier <tt>/administrator/components/com_helloworld/models/fields de</tt>.

A l'aide de votre gestionnaire de fichiers et éditeur préférés, ajoutez un fichier ''site/models/helloworld.php'' contenant :

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

Le nouveau type de champ affiche une liste déroulante des messages à choisir. Vous pouvez voir le résultat de ce changement dans le menu gestionnaire de la section Helloworld.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/17/fr

2015-07-22T09:03:34Z

Perete: Created page with "A l'aide de votre gestionnaire de fichiers et éditeur préférés, ajoutez un fichier ''site/models/helloworld.php'' contenant :"

A l'aide de votre gestionnaire de fichiers et éditeur préférés, ajoutez un fichier ''site/models/helloworld.php'' contenant :

J3.x:Developing an MVC Component/Using the database/fr

2015-07-22T09:03:08Z

Perete: Created page with "Le nouveau type de champ affiche une liste déroulante des messages à choisir. Vous pouvez voir le résultat de ce changement dans le menu gestionnaire de la section Helloworld."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

'''Remarque importante :''' Lorsque le composant est installé, les fichiers du dossier des mises à jour SQL (par exemple, ''admin/sql/updates/mysql'') sont lus et le nom du dernier fichier, dans l'ordre alphabétique, est utilisé pour ajouter le numéro de version du composant à la table <code>#__schemas</code>. Cette valeur doit être présente dans ce tableau afin que la mise à jour automatique puisse exécuter la mise à jour des fichiers SQL pour les futures versions. C'est pourquoi il est judicieux de créer un fichier de mise à jour SQL pour chaque version (même s'il est vide ou ne comporte qu'un commentaire). Ainsi, la version <code>#__schemas</code> correspondra toujours à la version du composant.

'''Remarque importante :''' Lors de l'enregistrement des fichiers SQL en utf8, assurez-vous de bien les enregistrer en utf8 SANS BOM, sinon la requête échouera avec l'erreur MySQL #1064.

Voici le fichier d'installation. Il sera exécuté si vous respectez un ordre approprié dans votre fichier <tt>helloworld.xml</tt>.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/uninstall.mysql.utf8.sql</tt> contenant:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modifier le fichier <tt>site/views/helloworld/tmpl/default.xml</tt> et ajouter ces lignes

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

Il introduit un nouveau type de champ et demande à Joomla de rechercher la définition de ce champ dans le dossier <tt>/administrator/components/com_helloworld/models/fields de</tt>.

With your favorite file manager and editor put a file ''admin/models/fields/helloworld.php'' file containing:

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

Le nouveau type de champ affiche une liste déroulante des messages à choisir. Vous pouvez voir le résultat de ce changement dans le menu gestionnaire de la section Helloworld.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/18/fr

2015-07-22T09:03:07Z

Le nouveau type de champ affiche une liste déroulante des messages à choisir. Vous pouvez voir le résultat de ce changement dans le menu gestionnaire de la section Helloworld.

J3.x:Developing an MVC Component/Using the database/fr

2015-07-22T09:01:22Z

Perete: Created page with "Il introduit un nouveau type de champ et demande à Joomla de rechercher la définition de ce champ dans le dossier <tt>/administrator/components/com_helloworld/models/fields..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

'''Remarque importante :''' Lorsque le composant est installé, les fichiers du dossier des mises à jour SQL (par exemple, ''admin/sql/updates/mysql'') sont lus et le nom du dernier fichier, dans l'ordre alphabétique, est utilisé pour ajouter le numéro de version du composant à la table <code>#__schemas</code>. Cette valeur doit être présente dans ce tableau afin que la mise à jour automatique puisse exécuter la mise à jour des fichiers SQL pour les futures versions. C'est pourquoi il est judicieux de créer un fichier de mise à jour SQL pour chaque version (même s'il est vide ou ne comporte qu'un commentaire). Ainsi, la version <code>#__schemas</code> correspondra toujours à la version du composant.

'''Remarque importante :''' Lors de l'enregistrement des fichiers SQL en utf8, assurez-vous de bien les enregistrer en utf8 SANS BOM, sinon la requête échouera avec l'erreur MySQL #1064.

Voici le fichier d'installation. Il sera exécuté si vous respectez un ordre approprié dans votre fichier <tt>helloworld.xml</tt>.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/uninstall.mysql.utf8.sql</tt> contenant:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modifier le fichier <tt>site/views/helloworld/tmpl/default.xml</tt> et ajouter ces lignes

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

Il introduit un nouveau type de champ et demande à Joomla de rechercher la définition de ce champ dans le dossier <tt>/administrator/components/com_helloworld/models/fields de</tt>.

With your favorite file manager and editor put a file ''admin/models/fields/helloworld.php'' file containing:

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

The new field type displays a drop-down list of messages to choose from. You can see the result of this change in the menu manager section for the helloworld item.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/16/fr

2015-07-22T09:01:22Z

Il introduit un nouveau type de champ et demande à Joomla de rechercher la définition de ce champ dans le dossier <tt>/administrator/components/com_helloworld/models/fields de</tt>.

J3.x:Developing an MVC Component/Using the database/fr

2015-07-22T08:55:03Z

Perete: Created page with "Modifier le fichier <tt>site/views/helloworld/tmpl/default.xml</tt> et ajouter ces lignes"

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

'''Remarque importante :''' Lorsque le composant est installé, les fichiers du dossier des mises à jour SQL (par exemple, ''admin/sql/updates/mysql'') sont lus et le nom du dernier fichier, dans l'ordre alphabétique, est utilisé pour ajouter le numéro de version du composant à la table <code>#__schemas</code>. Cette valeur doit être présente dans ce tableau afin que la mise à jour automatique puisse exécuter la mise à jour des fichiers SQL pour les futures versions. C'est pourquoi il est judicieux de créer un fichier de mise à jour SQL pour chaque version (même s'il est vide ou ne comporte qu'un commentaire). Ainsi, la version <code>#__schemas</code> correspondra toujours à la version du composant.

'''Remarque importante :''' Lors de l'enregistrement des fichiers SQL en utf8, assurez-vous de bien les enregistrer en utf8 SANS BOM, sinon la requête échouera avec l'erreur MySQL #1064.

Voici le fichier d'installation. Il sera exécuté si vous respectez un ordre approprié dans votre fichier <tt>helloworld.xml</tt>.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/uninstall.mysql.utf8.sql</tt> contenant:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modifier le fichier <tt>site/views/helloworld/tmpl/default.xml</tt> et ajouter ces lignes

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

It introduces a new field type and tells Joomla to look for the field definition in the <tt>/administrator/components/com_helloworld/models/fields</tt> folder.

With your favorite file manager and editor put a file ''admin/models/fields/helloworld.php'' file containing:

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

The new field type displays a drop-down list of messages to choose from. You can see the result of this change in the menu manager section for the helloworld item.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/15/fr

2015-07-22T08:55:02Z

Perete: Created page with "Modifier le fichier <tt>site/views/helloworld/tmpl/default.xml</tt> et ajouter ces lignes"

Modifier le fichier <tt>site/views/helloworld/tmpl/default.xml</tt> et ajouter ces lignes

J3.x:Developing an MVC Component/Using the database/fr

2015-07-22T07:48:23Z

Perete:

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

'''Remarque importante :''' Lorsque le composant est installé, les fichiers du dossier des mises à jour SQL (par exemple, ''admin/sql/updates/mysql'') sont lus et le nom du dernier fichier, dans l'ordre alphabétique, est utilisé pour ajouter le numéro de version du composant à la table <code>#__schemas</code>. Cette valeur doit être présente dans ce tableau afin que la mise à jour automatique puisse exécuter la mise à jour des fichiers SQL pour les futures versions. C'est pourquoi il est judicieux de créer un fichier de mise à jour SQL pour chaque version (même s'il est vide ou ne comporte qu'un commentaire). Ainsi, la version <code>#__schemas</code> correspondra toujours à la version du composant.

'''Remarque importante :''' Lors de l'enregistrement des fichiers SQL en utf8, assurez-vous de bien les enregistrer en utf8 SANS BOM, sinon la requête échouera avec l'erreur MySQL #1064.

Voici le fichier d'installation. Il sera exécuté si vous respectez un ordre approprié dans votre fichier <tt>helloworld.xml</tt>.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/uninstall.mysql.utf8.sql</tt> contenant:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modify the <tt>site/views/helloworld/tmpl/default.xml</tt> file and put these lines

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

It introduces a new field type and tells Joomla to look for the field definition in the <tt>/administrator/components/com_helloworld/models/fields</tt> folder.

With your favorite file manager and editor put a file ''admin/models/fields/helloworld.php'' file containing:

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

The new field type displays a drop-down list of messages to choose from. You can see the result of this change in the menu manager section for the helloworld item.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/12/fr

2015-07-22T07:48:23Z

Perete:

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/uninstall.mysql.utf8.sql</tt> contenant:

J3.x:Developing an MVC Component/Using the database/fr

2015-07-22T07:47:55Z

Perete: Created page with "Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/désinstaller.mysql.utf8.sql</tt> contenant:"

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

'''Remarque importante :''' Lorsque le composant est installé, les fichiers du dossier des mises à jour SQL (par exemple, ''admin/sql/updates/mysql'') sont lus et le nom du dernier fichier, dans l'ordre alphabétique, est utilisé pour ajouter le numéro de version du composant à la table <code>#__schemas</code>. Cette valeur doit être présente dans ce tableau afin que la mise à jour automatique puisse exécuter la mise à jour des fichiers SQL pour les futures versions. C'est pourquoi il est judicieux de créer un fichier de mise à jour SQL pour chaque version (même s'il est vide ou ne comporte qu'un commentaire). Ainsi, la version <code>#__schemas</code> correspondra toujours à la version du composant.

'''Remarque importante :''' Lors de l'enregistrement des fichiers SQL en utf8, assurez-vous de bien les enregistrer en utf8 SANS BOM, sinon la requête échouera avec l'erreur MySQL #1064.

Voici le fichier d'installation. Il sera exécuté si vous respectez un ordre approprié dans votre fichier <tt>helloworld.xml</tt>.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/désinstaller.mysql.utf8.sql</tt> contenant:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modify the <tt>site/views/helloworld/tmpl/default.xml</tt> file and put these lines

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

It introduces a new field type and tells Joomla to look for the field definition in the <tt>/administrator/components/com_helloworld/models/fields</tt> folder.

With your favorite file manager and editor put a file ''admin/models/fields/helloworld.php'' file containing:

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

The new field type displays a drop-down list of messages to choose from. You can see the result of this change in the menu manager section for the helloworld item.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/12/fr

2015-07-22T07:47:54Z

Perete: Created page with "Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/désinstaller.mysql.utf8.sql</tt> contenant:"

Avec votre gestionnaire de fichiers et éditeur préférés ajouter un fichier <tt>admin/sql/désinstaller.mysql.utf8.sql</tt> contenant:

J3.x:Developing an MVC Component/Using the database/fr

2015-07-21T09:59:00Z

Perete: Created page with "Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

'''Important Note:''' When the component is installed, the files in the SQL updates folder (for example, ''admin/sql/updates/mysql'') are read and the name of the last file alphabetically is used to populate the component's version number in the <code>#__schemas</code> table. This value must be in this table in order for the automatic update to execute the update SQL files for future versions. For this reason, it is good practice to create a SQL update file for each version (even if it is empty or just has a comment). This way the <code>#__schemas</code> version will always match the component version.

'''Important Note:''' When saving the SQL files in utf8, be sure to save them as utf8 NOT BOM or the query will fail with MySQL error #1064.

This is the install file. It will be executed if you put an appropriate order in the <tt>helloworld.xml</tt> file.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

With your favorite file manager and editor put a file <tt>admin/sql/uninstall.mysql.utf8.sql</tt> containing:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modify the <tt>site/views/helloworld/tmpl/default.xml</tt> file and put these lines

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

It introduces a new field type and tells Joomla to look for the field definition in the <tt>/administrator/components/com_helloworld/models/fields</tt> folder.

With your favorite file manager and editor put a file ''admin/models/fields/helloworld.php'' file containing:

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

The new field type displays a drop-down list of messages to choose from. You can see the result of this change in the menu manager section for the helloworld item.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/7/fr

2015-07-21T09:58:59Z

Le fichier <tt>install.mysql.utf8.sql</tt> sera exécuté lorsque vous installez le composant. Le fichier ''0.0.6.sql'' est exécuté lorsque vous effectuez une mise à jour.

J3.x:Developing an MVC Component/Using the database/fr

2015-07-21T09:56:48Z

Perete:

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

The file <tt>install.mysql.utf8.sql</tt> will be executed when you install this component. The file ''0.0.6.sql'' is executed when you do an update.

'''Important Note:''' When the component is installed, the files in the SQL updates folder (for example, ''admin/sql/updates/mysql'') are read and the name of the last file alphabetically is used to populate the component's version number in the <code>#__schemas</code> table. This value must be in this table in order for the automatic update to execute the update SQL files for future versions. For this reason, it is good practice to create a SQL update file for each version (even if it is empty or just has a comment). This way the <code>#__schemas</code> version will always match the component version.

'''Important Note:''' When saving the SQL files in utf8, be sure to save them as utf8 NOT BOM or the query will fail with MySQL error #1064.

This is the install file. It will be executed if you put an appropriate order in the <tt>helloworld.xml</tt> file.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

With your favorite file manager and editor put a file <tt>admin/sql/uninstall.mysql.utf8.sql</tt> containing:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modify the <tt>site/views/helloworld/tmpl/default.xml</tt> file and put these lines

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

It introduces a new field type and tells Joomla to look for the field definition in the <tt>/administrator/components/com_helloworld/models/fields</tt> folder.

With your favorite file manager and editor put a file ''admin/models/fields/helloworld.php'' file containing:

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

The new field type displays a drop-down list of messages to choose from. You can see the result of this change in the menu manager section for the helloworld item.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/6/fr

2015-07-21T09:56:47Z

Perete:

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/install.mysql.utf8.sql</tt> et <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

J3.x:Developing an MVC Component/Using the database/fr

2015-07-21T09:54:36Z

Perete: Created page with "Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/installer.mysql.utf8.sql</tt> et <tt>admin/sql/mises à jour/mysql/0.0..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/installer.mysql.utf8.sql</tt> et <tt>admin/sql/mises à jour/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

The file <tt>install.mysql.utf8.sql</tt> will be executed when you install this component. The file ''0.0.6.sql'' is executed when you do an update.

'''Important Note:''' When the component is installed, the files in the SQL updates folder (for example, ''admin/sql/updates/mysql'') are read and the name of the last file alphabetically is used to populate the component's version number in the <code>#__schemas</code> table. This value must be in this table in order for the automatic update to execute the update SQL files for future versions. For this reason, it is good practice to create a SQL update file for each version (even if it is empty or just has a comment). This way the <code>#__schemas</code> version will always match the component version.

'''Important Note:''' When saving the SQL files in utf8, be sure to save them as utf8 NOT BOM or the query will fail with MySQL error #1064.

This is the install file. It will be executed if you put an appropriate order in the <tt>helloworld.xml</tt> file.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

With your favorite file manager and editor put a file <tt>admin/sql/uninstall.mysql.utf8.sql</tt> containing:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modify the <tt>site/views/helloworld/tmpl/default.xml</tt> file and put these lines

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

It introduces a new field type and tells Joomla to look for the field definition in the <tt>/administrator/components/com_helloworld/models/fields</tt> folder.

With your favorite file manager and editor put a file ''admin/models/fields/helloworld.php'' file containing:

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

The new field type displays a drop-down list of messages to choose from. You can see the result of this change in the menu manager section for the helloworld item.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/6/fr

2015-07-21T09:54:35Z

Avec votre gestionnaire de fichiers et éditeur préférés, créer deux fichiers appelés <tt>admin/sql/installer.mysql.utf8.sql</tt> et <tt>admin/sql/mises à jour/mysql/0.0.6.sql</tt>. Ils devraient tous les deux avoir le même contenu :

J3.x:Developing an MVC Component/Using the database/fr

2015-07-21T09:41:44Z

Perete: Created page with "Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous p..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.

== Utiliser la base de données ==
Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

With your favorite file manager and editor create two files called <tt>admin/sql/install.mysql.utf8.sql</tt> and <tt>admin/sql/updates/mysql/0.0.6.sql</tt>. They should both have the same content, as follows:

<span id="admin/sql/install.mysql.utf8.sql">
<tt>'''admin/sql/install.mysql.utf8.sql''' and '''admin/sql/updates/mysql/0.0.6.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;

CREATE TABLE `#__helloworld` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`greeting` VARCHAR(25) NOT NULL,
`published` tinyint(4) NOT NULL,
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

INSERT INTO `#__helloworld` (`greeting`) VALUES
('Hello World!'),
('Good bye World!');

</source>
</span>

The file <tt>install.mysql.utf8.sql</tt> will be executed when you install this component. The file ''0.0.6.sql'' is executed when you do an update.

'''Important Note:''' When the component is installed, the files in the SQL updates folder (for example, ''admin/sql/updates/mysql'') are read and the name of the last file alphabetically is used to populate the component's version number in the <code>#__schemas</code> table. This value must be in this table in order for the automatic update to execute the update SQL files for future versions. For this reason, it is good practice to create a SQL update file for each version (even if it is empty or just has a comment). This way the <code>#__schemas</code> version will always match the component version.

'''Important Note:''' When saving the SQL files in utf8, be sure to save them as utf8 NOT BOM or the query will fail with MySQL error #1064.

This is the install file. It will be executed if you put an appropriate order in the <tt>helloworld.xml</tt> file.

<span id="helloworld.xml">
<tt>'''helloworld.xml'''</tt>
<source lang="xml" highlight="13,17-26,58-61">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.6</version>

<description>Description of the Hello World component ...</description>

<install> 
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> 
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>

<folder>tables</folder>

<folder>models</folder>
</files>
</administration>

</extension>
</source>
</span>

Faites de même avec le fichier de désinstallation :

With your favorite file manager and editor put a file <tt>admin/sql/uninstall.mysql.utf8.sql</tt> containing:

<span id="admin/sql/uninstall.mysql.utf8.sql">
<tt>'''admin/sql/uninstall.mysql.utf8.sql'''</tt>
<source lang="sql">
DROP TABLE IF EXISTS `#__helloworld`;
</source>
</span>

== Ajouter un nouveau type de champ ==
For the moment, we have used a [[S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part|hard coded field type for messages]]. We need to use our database for choosing the message.

Modify the <tt>site/views/helloworld/tmpl/default.xml</tt> file and put these lines

<span id="site/views/helloworld/tmpl/default.xml">
<tt>'''site/views/helloworld/tmpl/default.xml'''</tt>
<source lang="xml" highlight="8,11-16">
<?xml version="1.0" encoding="utf-8"?>
<metadata>
<layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
<message>COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC</message>
</layout>
<fields
name="request"
addfieldpath="/administrator/components/com_helloworld/models/fields"
>
<fieldset name="request">
<field
name="id"
type="helloworld"
label="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC"
/>
</fieldset>
</fields>
</metadata>
</source>
</span>

It introduces a new field type and tells Joomla to look for the field definition in the <tt>/administrator/components/com_helloworld/models/fields</tt> folder.

With your favorite file manager and editor put a file ''admin/models/fields/helloworld.php'' file containing:

<span id="admin/models/fields/helloworld.php">
<tt>'''admin/models/fields/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

JFormHelper::loadFieldClass('list');

/**
* HelloWorld Form Field class for the HelloWorld component
*
* @since 0.0.1
*/
class JFormFieldHelloWorld extends JFormFieldList
{
/**
* The field type.
*
* @var string
*/
protected $type = 'HelloWorld';

/**
* Method to get a list of options for a list input.
*
* @return array An array of JHtml options.
*/
protected function getOptions()
{
$db = JFactory::getDBO();
$query = $db->getQuery(true);
$query->select('id,greeting');
$query->from('#__helloworld');
$db->setQuery((string) $query);
$messages = $db->loadObjectList();
$options = array();

if ($messages)
{
foreach ($messages as $message)
{
$options[] = JHtml::_('select.option', $message->id, $message->greeting);
}
}

$options = array_merge(parent::getOptions(), $options);

return $options;
}
}

</source>
</span>

The new field type displays a drop-down list of messages to choose from. You can see the result of this change in the menu manager section for the helloworld item.

== Afficher le message sélectionné ==
When a menu item of this component is created/updated, Joomla stores the identifier of the message. The <tt>HelloWorldModelHelloWorld</tt> model has now to compute the message according to this identifier and the data stored in the database.

Modifiez le fichier <tt>site/models/helloworld.php</tt> :

<span id="site/models/helloworld.php">
<tt>'''site/models/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelItem
{
/**
* @var array messages
*/
protected $messages;

/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}

/**
* Get the message
*
* @param integer $id Greeting Id
*
* @return string Fetched String from Table for relevant Id
*/
public function getMsg($id = 1)
{
if (!is_array($this->messages))
{
$this->messages = array();
}

if (!isset($this->messages[$id]))
{
// Request the selected id
$jinput = JFactory::getApplication()->input;
$id = $jinput->get('id', 1, 'INT');

// Get a TableHelloWorld instance
$table = $this->getTable();

// Load the message
$table->load($id);

// Assign the message
$this->messages[$id] = $table->greeting;
}

return $this->messages[$id];
}
}

</source>
</span>

The model now asks the ''TableHelloWorld'' to get the message. This table class has to be defined in <tt>admin/tables/helloworld.php</tt> file

<span id="admin/tables/helloworld.php">
<tt>'''admin/tables/helloworld.php'''</tt>
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');

/**
* Hello Table class
*
* @since 0.0.1
*/
class HelloWorldTableHelloWorld extends JTable
{
/**
* Constructor
*
* @param JDatabaseDriver &$db A database connector object
*/
function __construct(&$db)
{
parent::__construct('#__helloworld', 'id', $db);
}
}

</source>
</span>

You shouldn't see any differences, but if you access the database you should see a table named ''jos_helloworld'' with two columns: id and greeting. And two entries: ''Hello World!'' and ''Good bye World''.

== Empaqueter le composant ==

Contenu de votre répertoire de code

* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]''
* ''[[#site/models/helloworld.php|site/models/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]''
* ''[[#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''
* ''[[#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]''
* ''[[#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]''
* ''[[#admin/tables/helloworld.php|admin/tables/helloworld.php]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez ajouter un élément de menu pour ce composant à l'aide du gestionnaire de menus dans le backend.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

== Contributors ==
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Préc. : Ajouter une requête de variable dans le type de menu|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Suiv. : Backend de base|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/5/fr

2015-07-21T09:41:43Z

Les composants gèrent généralement leur contenu à l'aide de la base de données. Lors de la procédure d'installation/désinstallation/mise à jour d'un composant, vous pouvez exécuter des requêtes SQL par l'utilisation de fichiers texte SQL.

J3.x:Developing an MVC Component/Adding a view to the site part/fr

2015-07-20T09:06:16Z

Perete:

<noinclude><languages /></noinclude>
{{review}}
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.
Dans le framework Joomla! 3.x, les auteurs des composants tiers ont divisé leur code en trois parties principales:
* ''modèles'' : ils gèrent les données
* ''contrôleurs'' : ils exécutent les tâches, définissent et récupèrent les états des modèles et demandent aux vues de s'afficher
* ''vues'' : elles affichent le contenu en fonction du type (''error'', ''feed'', ''html'', ''json'', ''raw'', ''xml'') et la mise en page choisie par les contrôleurs.
== Configurer le contrôleur ==
Dans le code du noyau Joomla, il existe une classe capable de gérer les contrôleurs : ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html JControllerLegacy]''. Cette classe doit être étendue afin d'être utilisée dans notre composant. Dans le fichier <tt>votresite/components/com_helloworld/helloworld.php</tt> (point d'entrée de notre composant ''Hello World''), ajoutez ces lignes :

{{vanchor|site/helloworld.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

// Get an instance of the controller prefixed by HelloWorld
$controller = JControllerLegacy::getInstance('HelloWorld');

// Perform the Request task
$input = JFactory::getApplication()->input;
$controller->execute($input->getCmd('task'));

// Redirect if set by the controller
$controller->redirect();

</source>

La méthode statique ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html#method_getInstance getInstance]'' de la classe ''JControllerLegacy'' va créer un contrôleur. Dans le code ci-dessus, cela va instancier un objet contrôleur de la classe nommée ''HelloWorldController''. Joomla va chercher la déclaration de cette classe dans un fichier nommé <tt>votresitee/components/com_helloworld/controller.php</tt> (c'est un comportement par défaut).

Maintenant, <tt>controller.php</tt> doit être créé et "HelloWorldController" doit être déclaré et défini. A l'aide de votre gestionnaire de fichiers et éditeur préférés, créez un fichier <tt>votresite/components/com_helloworld/controller.php</tt> contenant :

{{vanchor|site/controller.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* Hello World Component Controller
*
* @since 0.0.1
*/
class HelloWorldController extends JControllerLegacy
{
}
</source>

Si aucune tâche (''task'') n'est indiquée dans les variables de requête, la tâche par défaut sera exécutée. Par défaut, la tâche ''display''. La classe ''JControllerLegacy'' possède une telle tâche. Dans notre exemple, elle affichera une vue nommée ''HelloWorld''.

Ainsi, avec tout simplement ''task'', une fonction publique display() de ''JControllerLegacy'' est référencée.

{{tip|Aparté : vous pourriez appeler une autre fonction adjointe à ''display()'' en utilisant une URL comme celle-ci :

<pre>http://localhost/index.php?option=com_helloworld&task=insert</pre>

Ceci va appeler une fonction ''insert()'' de notre contrôleur (que nous devrons implémenter dans ''HelloWorldController'' ).}}

== Configurer la vue ==
Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>.

Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/components/com_helloworld/views/helloworld/</tt>.

Le fichier qui va contenir le code de la vue est appelée <tt>view.[view_mode].php</tt>. Le mode d'affichage par défaut, et probablement la seule vue d'un composant est le mode "html". Donc cela nous donne notre nom de fichier qui sera : <tt>view.html.php</tt>.

Avec votre gestionnaire de fichiers et éditeur préférés, "créer un fichier" <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt> permettant d'afficher la vue par défaut avec le code ci-dessous :

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HTML View class for the HelloWorld Component
*
* @since 0.0.1
*/
class HelloWorldViewHelloWorld extends JViewLegacy
{
/**
* Display the Hello World view
*
* @param string $tpl The name of the template file to parse; automatically searches through the template paths.
*
* @return void
*/
function display($tpl = null)
{
// Assign data to the view
$this->msg = 'Hello World';

// Display the view
parent::display($tpl);
}
}

</source>

The ''display'' method of the ''[https://api.joomla.org/cms-3/classes/JViewLegacy.html JViewLegacy]'' class is called with the ''display'' task of the JControllerLegacy class. In our case, this method will display data using the ''tmpl/default.php'' file. With your favorite file manager and editor, create a file '''<tt>yoursite/components/com_helloworld/views/helloworld/tmpl/default.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');
?>
<h1><?php echo $this->msg; ?></h1>

</source>

This template file will be included by the JViewLegacy class. Therefore, here, $this refers to the HelloWorldViewHelloWorld class.

So to give an example, one could call the view inside the ''yoursite/components/com_[component_name]/views/[name of view]/'' folder by calling <code>index.php?option=com_helloworld</code> (this would default to the <tt>yoursite/components/com_helloworld/views/helloworld/</tt> folder) or we could explicitly call the folder by calling:

<code>index.php?option=com_helloworld&view=helloworld</code>

if we change <code>&view=helloworld</code> to something else, e.g. <code>&view=fluffy</code> we would have to create a folder <code>components/com_helloworld/views/fluffy/</code>.

Copy the contents of <code>views/helloworld</code> to <code>views/fluffy</code>

The classname of the file <code>view.html.php</code> of the fluffy folder would be ''HelloWorldViewFluffy''. Afterwards you can customize the contents of ''default.php'' of the ''fluffy'' subfolder for custom output and see the output by calling <code>index.php?option=com_helloworld&view=fluffy</code>

== Empaqueter le composant ==
Contenu de votre répertoire de code
* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-2-adding-a-site-view.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez tester ce composant simple en indiquant ''index.php?option=com_helloworld'' dans la barre d'adresse de votre navigateur.

<span id="helloworld.xml">
<tt>helloworld.xml</tt>
<source lang="xml" highlight="13,30,31">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>December 2013</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.2</version>

<description>Description of the Hello World component ...</description>

<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>
</files>
</administration>

</extension>
</source>
</span>

'''Résultat :'''
Vous verrez par défaut le message contenu dans la variable ''$this->msg'' du fichier <tt>view.html.php</tt>.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

==Contributeurs==
*[[User:Gunjanpatel|Gunjan Patel]]
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:Scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Developing_a_Basic_Component|Préc. : Développement d'un composant simple|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_a_menu_type_to_the_site_part|Suiv : Ajout d'un type de menu à la partie site|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Adding a view to the site part/25/fr

2015-07-20T09:06:15Z

Perete:

Avec votre gestionnaire de fichiers et éditeur préférés, "créer un fichier" <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt> permettant d'afficher la vue par défaut avec le code ci-dessous :

J3.x:Developing an MVC Component/Adding a view to the site part/fr

2015-07-20T08:58:00Z

Perete:

<noinclude><languages /></noinclude>
{{review}}
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.
Dans le framework Joomla! 3.x, les auteurs des composants tiers ont divisé leur code en trois parties principales:
* ''modèles'' : ils gèrent les données
* ''contrôleurs'' : ils exécutent les tâches, définissent et récupèrent les états des modèles et demandent aux vues de s'afficher
* ''vues'' : elles affichent le contenu en fonction du type (''error'', ''feed'', ''html'', ''json'', ''raw'', ''xml'') et la mise en page choisie par les contrôleurs.
== Configurer le contrôleur ==
Dans le code du noyau Joomla, il existe une classe capable de gérer les contrôleurs : ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html JControllerLegacy]''. Cette classe doit être étendue afin d'être utilisée dans notre composant. Dans le fichier <tt>votresite/components/com_helloworld/helloworld.php</tt> (point d'entrée de notre composant ''Hello World''), ajoutez ces lignes :

{{vanchor|site/helloworld.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

// Get an instance of the controller prefixed by HelloWorld
$controller = JControllerLegacy::getInstance('HelloWorld');

// Perform the Request task
$input = JFactory::getApplication()->input;
$controller->execute($input->getCmd('task'));

// Redirect if set by the controller
$controller->redirect();

</source>

La méthode statique ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html#method_getInstance getInstance]'' de la classe ''JControllerLegacy'' va créer un contrôleur. Dans le code ci-dessus, cela va instancier un objet contrôleur de la classe nommée ''HelloWorldController''. Joomla va chercher la déclaration de cette classe dans un fichier nommé <tt>votresitee/components/com_helloworld/controller.php</tt> (c'est un comportement par défaut).

Maintenant, <tt>controller.php</tt> doit être créé et "HelloWorldController" doit être déclaré et défini. A l'aide de votre gestionnaire de fichiers et éditeur préférés, créez un fichier <tt>votresite/components/com_helloworld/controller.php</tt> contenant :

{{vanchor|site/controller.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* Hello World Component Controller
*
* @since 0.0.1
*/
class HelloWorldController extends JControllerLegacy
{
}
</source>

Si aucune tâche (''task'') n'est indiquée dans les variables de requête, la tâche par défaut sera exécutée. Par défaut, la tâche ''display''. La classe ''JControllerLegacy'' possède une telle tâche. Dans notre exemple, elle affichera une vue nommée ''HelloWorld''.

Ainsi, avec tout simplement ''task'', une fonction publique display() de ''JControllerLegacy'' est référencée.

{{tip|Aparté : vous pourriez appeler une autre fonction adjointe à ''display()'' en utilisant une URL comme celle-ci :

<pre>http://localhost/index.php?option=com_helloworld&task=insert</pre>

Ceci va appeler une fonction ''insert()'' de notre contrôleur (que nous devrons implémenter dans ''HelloWorldController'' ).}}

== Configurer la vue ==
Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>.

Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/components/com_helloworld/views/helloworld/</tt>.

Le fichier qui va contenir le code de la vue est appelée <tt>view.[view_mode].php</tt>. Le mode d'affichage par défaut, et probablement la seule vue d'un composant est le mode "html". Donc cela nous donne notre nom de fichier qui sera : <tt>view.html.php</tt>.

Avec votre gestionnaire de fichiers et éditeur préférés, "" créer un fichier"" <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt> permettant d'afficher la vue par défaut avec le code ci-dessous :

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HTML View class for the HelloWorld Component
*
* @since 0.0.1
*/
class HelloWorldViewHelloWorld extends JViewLegacy
{
/**
* Display the Hello World view
*
* @param string $tpl The name of the template file to parse; automatically searches through the template paths.
*
* @return void
*/
function display($tpl = null)
{
// Assign data to the view
$this->msg = 'Hello World';

// Display the view
parent::display($tpl);
}
}

</source>

The ''display'' method of the ''[https://api.joomla.org/cms-3/classes/JViewLegacy.html JViewLegacy]'' class is called with the ''display'' task of the JControllerLegacy class. In our case, this method will display data using the ''tmpl/default.php'' file. With your favorite file manager and editor, create a file '''<tt>yoursite/components/com_helloworld/views/helloworld/tmpl/default.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');
?>
<h1><?php echo $this->msg; ?></h1>

</source>

This template file will be included by the JViewLegacy class. Therefore, here, $this refers to the HelloWorldViewHelloWorld class.

So to give an example, one could call the view inside the ''yoursite/components/com_[component_name]/views/[name of view]/'' folder by calling <code>index.php?option=com_helloworld</code> (this would default to the <tt>yoursite/components/com_helloworld/views/helloworld/</tt> folder) or we could explicitly call the folder by calling:

<code>index.php?option=com_helloworld&view=helloworld</code>

if we change <code>&view=helloworld</code> to something else, e.g. <code>&view=fluffy</code> we would have to create a folder <code>components/com_helloworld/views/fluffy/</code>.

Copy the contents of <code>views/helloworld</code> to <code>views/fluffy</code>

The classname of the file <code>view.html.php</code> of the fluffy folder would be ''HelloWorldViewFluffy''. Afterwards you can customize the contents of ''default.php'' of the ''fluffy'' subfolder for custom output and see the output by calling <code>index.php?option=com_helloworld&view=fluffy</code>

== Empaqueter le composant ==
Contenu de votre répertoire de code
* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-2-adding-a-site-view.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez tester ce composant simple en indiquant ''index.php?option=com_helloworld'' dans la barre d'adresse de votre navigateur.

<span id="helloworld.xml">
<tt>helloworld.xml</tt>
<source lang="xml" highlight="13,30,31">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>December 2013</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.2</version>

<description>Description of the Hello World component ...</description>

<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>
</files>
</administration>

</extension>
</source>
</span>

'''Résultat :'''
Vous verrez par défaut le message contenu dans la variable ''$this->msg'' du fichier <tt>view.html.php</tt>.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

==Contributeurs==
*[[User:Gunjanpatel|Gunjan Patel]]
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:Scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Developing_a_Basic_Component|Préc. : Développement d'un composant simple|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_a_menu_type_to_the_site_part|Suiv : Ajout d'un type de menu à la partie site|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Adding a view to the site part/25/fr

2015-07-20T08:58:00Z

Perete:

Avec votre gestionnaire de fichiers et éditeur préférés, "" créer un fichier"" <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt> permettant d'afficher la vue par défaut avec le code ci-dessous :

J3.x:Developing an MVC Component/Adding a view to the site part/fr

2015-07-20T08:56:52Z

Perete: Created page with "Avec votre gestionnaire de fichiers et éditeur préférés, "" créer un fichier <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt>"" permettant d'af..."

<noinclude><languages /></noinclude>
{{review}}
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.
Dans le framework Joomla! 3.x, les auteurs des composants tiers ont divisé leur code en trois parties principales:
* ''modèles'' : ils gèrent les données
* ''contrôleurs'' : ils exécutent les tâches, définissent et récupèrent les états des modèles et demandent aux vues de s'afficher
* ''vues'' : elles affichent le contenu en fonction du type (''error'', ''feed'', ''html'', ''json'', ''raw'', ''xml'') et la mise en page choisie par les contrôleurs.
== Configurer le contrôleur ==
Dans le code du noyau Joomla, il existe une classe capable de gérer les contrôleurs : ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html JControllerLegacy]''. Cette classe doit être étendue afin d'être utilisée dans notre composant. Dans le fichier <tt>votresite/components/com_helloworld/helloworld.php</tt> (point d'entrée de notre composant ''Hello World''), ajoutez ces lignes :

{{vanchor|site/helloworld.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

// Get an instance of the controller prefixed by HelloWorld
$controller = JControllerLegacy::getInstance('HelloWorld');

// Perform the Request task
$input = JFactory::getApplication()->input;
$controller->execute($input->getCmd('task'));

// Redirect if set by the controller
$controller->redirect();

</source>

La méthode statique ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html#method_getInstance getInstance]'' de la classe ''JControllerLegacy'' va créer un contrôleur. Dans le code ci-dessus, cela va instancier un objet contrôleur de la classe nommée ''HelloWorldController''. Joomla va chercher la déclaration de cette classe dans un fichier nommé <tt>votresitee/components/com_helloworld/controller.php</tt> (c'est un comportement par défaut).

Maintenant, <tt>controller.php</tt> doit être créé et "HelloWorldController" doit être déclaré et défini. A l'aide de votre gestionnaire de fichiers et éditeur préférés, créez un fichier <tt>votresite/components/com_helloworld/controller.php</tt> contenant :

{{vanchor|site/controller.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* Hello World Component Controller
*
* @since 0.0.1
*/
class HelloWorldController extends JControllerLegacy
{
}
</source>

Si aucune tâche (''task'') n'est indiquée dans les variables de requête, la tâche par défaut sera exécutée. Par défaut, la tâche ''display''. La classe ''JControllerLegacy'' possède une telle tâche. Dans notre exemple, elle affichera une vue nommée ''HelloWorld''.

Ainsi, avec tout simplement ''task'', une fonction publique display() de ''JControllerLegacy'' est référencée.

{{tip|Aparté : vous pourriez appeler une autre fonction adjointe à ''display()'' en utilisant une URL comme celle-ci :

<pre>http://localhost/index.php?option=com_helloworld&task=insert</pre>

Ceci va appeler une fonction ''insert()'' de notre contrôleur (que nous devrons implémenter dans ''HelloWorldController'' ).}}

== Configurer la vue ==
Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>.

Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/components/com_helloworld/views/helloworld/</tt>.

Le fichier qui va contenir le code de la vue est appelée <tt>view.[view_mode].php</tt>. Le mode d'affichage par défaut, et probablement la seule vue d'un composant est le mode "html". Donc cela nous donne notre nom de fichier qui sera : <tt>view.html.php</tt>.

Avec votre gestionnaire de fichiers et éditeur préférés, "" créer un fichier <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt>"" permettant d'afficher la vue par défaut avec le code ci-dessous :

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HTML View class for the HelloWorld Component
*
* @since 0.0.1
*/
class HelloWorldViewHelloWorld extends JViewLegacy
{
/**
* Display the Hello World view
*
* @param string $tpl The name of the template file to parse; automatically searches through the template paths.
*
* @return void
*/
function display($tpl = null)
{
// Assign data to the view
$this->msg = 'Hello World';

// Display the view
parent::display($tpl);
}
}

</source>

The ''display'' method of the ''[https://api.joomla.org/cms-3/classes/JViewLegacy.html JViewLegacy]'' class is called with the ''display'' task of the JControllerLegacy class. In our case, this method will display data using the ''tmpl/default.php'' file. With your favorite file manager and editor, create a file '''<tt>yoursite/components/com_helloworld/views/helloworld/tmpl/default.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');
?>
<h1><?php echo $this->msg; ?></h1>

</source>

This template file will be included by the JViewLegacy class. Therefore, here, $this refers to the HelloWorldViewHelloWorld class.

So to give an example, one could call the view inside the ''yoursite/components/com_[component_name]/views/[name of view]/'' folder by calling <code>index.php?option=com_helloworld</code> (this would default to the <tt>yoursite/components/com_helloworld/views/helloworld/</tt> folder) or we could explicitly call the folder by calling:

<code>index.php?option=com_helloworld&view=helloworld</code>

if we change <code>&view=helloworld</code> to something else, e.g. <code>&view=fluffy</code> we would have to create a folder <code>components/com_helloworld/views/fluffy/</code>.

Copy the contents of <code>views/helloworld</code> to <code>views/fluffy</code>

The classname of the file <code>view.html.php</code> of the fluffy folder would be ''HelloWorldViewFluffy''. Afterwards you can customize the contents of ''default.php'' of the ''fluffy'' subfolder for custom output and see the output by calling <code>index.php?option=com_helloworld&view=fluffy</code>

== Empaqueter le composant ==
Contenu de votre répertoire de code
* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-2-adding-a-site-view.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez tester ce composant simple en indiquant ''index.php?option=com_helloworld'' dans la barre d'adresse de votre navigateur.

<span id="helloworld.xml">
<tt>helloworld.xml</tt>
<source lang="xml" highlight="13,30,31">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>December 2013</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.2</version>

<description>Description of the Hello World component ...</description>

<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>
</files>
</administration>

</extension>
</source>
</span>

'''Résultat :'''
Vous verrez par défaut le message contenu dans la variable ''$this->msg'' du fichier <tt>view.html.php</tt>.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

==Contributeurs==
*[[User:Gunjanpatel|Gunjan Patel]]
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:Scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Developing_a_Basic_Component|Préc. : Développement d'un composant simple|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_a_menu_type_to_the_site_part|Suiv : Ajout d'un type de menu à la partie site|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Adding a view to the site part/25/fr

2015-07-20T08:56:51Z

Avec votre gestionnaire de fichiers et éditeur préférés, "" créer un fichier <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt>"" permettant d'afficher la vue par défaut avec le code ci-dessous :

J3.x:Developing an MVC Component/Adding a view to the site part/fr

2015-07-20T08:52:44Z

Perete: Created page with "Le fichier qui va contenir le code de la vue est appelée <tt>view.[view_mode].php</tt>. Le mode d'affichage par défaut, et probablement la seule vue d'un composant est le mo..."

<noinclude><languages /></noinclude>
{{review}}
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.
Dans le framework Joomla! 3.x, les auteurs des composants tiers ont divisé leur code en trois parties principales:
* ''modèles'' : ils gèrent les données
* ''contrôleurs'' : ils exécutent les tâches, définissent et récupèrent les états des modèles et demandent aux vues de s'afficher
* ''vues'' : elles affichent le contenu en fonction du type (''error'', ''feed'', ''html'', ''json'', ''raw'', ''xml'') et la mise en page choisie par les contrôleurs.
== Configurer le contrôleur ==
Dans le code du noyau Joomla, il existe une classe capable de gérer les contrôleurs : ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html JControllerLegacy]''. Cette classe doit être étendue afin d'être utilisée dans notre composant. Dans le fichier <tt>votresite/components/com_helloworld/helloworld.php</tt> (point d'entrée de notre composant ''Hello World''), ajoutez ces lignes :

{{vanchor|site/helloworld.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

// Get an instance of the controller prefixed by HelloWorld
$controller = JControllerLegacy::getInstance('HelloWorld');

// Perform the Request task
$input = JFactory::getApplication()->input;
$controller->execute($input->getCmd('task'));

// Redirect if set by the controller
$controller->redirect();

</source>

La méthode statique ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html#method_getInstance getInstance]'' de la classe ''JControllerLegacy'' va créer un contrôleur. Dans le code ci-dessus, cela va instancier un objet contrôleur de la classe nommée ''HelloWorldController''. Joomla va chercher la déclaration de cette classe dans un fichier nommé <tt>votresitee/components/com_helloworld/controller.php</tt> (c'est un comportement par défaut).

Maintenant, <tt>controller.php</tt> doit être créé et "HelloWorldController" doit être déclaré et défini. A l'aide de votre gestionnaire de fichiers et éditeur préférés, créez un fichier <tt>votresite/components/com_helloworld/controller.php</tt> contenant :

{{vanchor|site/controller.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* Hello World Component Controller
*
* @since 0.0.1
*/
class HelloWorldController extends JControllerLegacy
{
}
</source>

Si aucune tâche (''task'') n'est indiquée dans les variables de requête, la tâche par défaut sera exécutée. Par défaut, la tâche ''display''. La classe ''JControllerLegacy'' possède une telle tâche. Dans notre exemple, elle affichera une vue nommée ''HelloWorld''.

Ainsi, avec tout simplement ''task'', une fonction publique display() de ''JControllerLegacy'' est référencée.

{{tip|Aparté : vous pourriez appeler une autre fonction adjointe à ''display()'' en utilisant une URL comme celle-ci :

<pre>http://localhost/index.php?option=com_helloworld&task=insert</pre>

Ceci va appeler une fonction ''insert()'' de notre contrôleur (que nous devrons implémenter dans ''HelloWorldController'' ).}}

== Configurer la vue ==
Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>.

Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/components/com_helloworld/views/helloworld/</tt>.

Le fichier qui va contenir le code de la vue est appelée <tt>view.[view_mode].php</tt>. Le mode d'affichage par défaut, et probablement la seule vue d'un composant est le mode "html". Donc cela nous donne notre nom de fichier qui sera : <tt>view.html.php</tt>.

With your favorite file manager and editor, '''create a file <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HTML View class for the HelloWorld Component
*
* @since 0.0.1
*/
class HelloWorldViewHelloWorld extends JViewLegacy
{
/**
* Display the Hello World view
*
* @param string $tpl The name of the template file to parse; automatically searches through the template paths.
*
* @return void
*/
function display($tpl = null)
{
// Assign data to the view
$this->msg = 'Hello World';

// Display the view
parent::display($tpl);
}
}

</source>

The ''display'' method of the ''[https://api.joomla.org/cms-3/classes/JViewLegacy.html JViewLegacy]'' class is called with the ''display'' task of the JControllerLegacy class. In our case, this method will display data using the ''tmpl/default.php'' file. With your favorite file manager and editor, create a file '''<tt>yoursite/components/com_helloworld/views/helloworld/tmpl/default.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');
?>
<h1><?php echo $this->msg; ?></h1>

</source>

This template file will be included by the JViewLegacy class. Therefore, here, $this refers to the HelloWorldViewHelloWorld class.

So to give an example, one could call the view inside the ''yoursite/components/com_[component_name]/views/[name of view]/'' folder by calling <code>index.php?option=com_helloworld</code> (this would default to the <tt>yoursite/components/com_helloworld/views/helloworld/</tt> folder) or we could explicitly call the folder by calling:

<code>index.php?option=com_helloworld&view=helloworld</code>

if we change <code>&view=helloworld</code> to something else, e.g. <code>&view=fluffy</code> we would have to create a folder <code>components/com_helloworld/views/fluffy/</code>.

Copy the contents of <code>views/helloworld</code> to <code>views/fluffy</code>

The classname of the file <code>view.html.php</code> of the fluffy folder would be ''HelloWorldViewFluffy''. Afterwards you can customize the contents of ''default.php'' of the ''fluffy'' subfolder for custom output and see the output by calling <code>index.php?option=com_helloworld&view=fluffy</code>

== Empaqueter le composant ==
Contenu de votre répertoire de code
* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-2-adding-a-site-view.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez tester ce composant simple en indiquant ''index.php?option=com_helloworld'' dans la barre d'adresse de votre navigateur.

<span id="helloworld.xml">
<tt>helloworld.xml</tt>
<source lang="xml" highlight="13,30,31">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>December 2013</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.2</version>

<description>Description of the Hello World component ...</description>

<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>
</files>
</administration>

</extension>
</source>
</span>

'''Résultat :'''
Vous verrez par défaut le message contenu dans la variable ''$this->msg'' du fichier <tt>view.html.php</tt>.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

==Contributeurs==
*[[User:Gunjanpatel|Gunjan Patel]]
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:Scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Developing_a_Basic_Component|Préc. : Développement d'un composant simple|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_a_menu_type_to_the_site_part|Suiv : Ajout d'un type de menu à la partie site|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Adding a view to the site part/24/fr

2015-07-20T08:52:43Z

Le fichier qui va contenir le code de la vue est appelée <tt>view.[view_mode].php</tt>. Le mode d'affichage par défaut, et probablement la seule vue d'un composant est le mode "html". Donc cela nous donne notre nom de fichier qui sera : <tt>view.html.php</tt>.

J3.x:Developing an MVC Component/Adding a view to the site part/fr

2015-07-20T08:48:34Z

Perete:

<noinclude><languages /></noinclude>
{{review}}
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.
Dans le framework Joomla! 3.x, les auteurs des composants tiers ont divisé leur code en trois parties principales:
* ''modèles'' : ils gèrent les données
* ''contrôleurs'' : ils exécutent les tâches, définissent et récupèrent les états des modèles et demandent aux vues de s'afficher
* ''vues'' : elles affichent le contenu en fonction du type (''error'', ''feed'', ''html'', ''json'', ''raw'', ''xml'') et la mise en page choisie par les contrôleurs.
== Configurer le contrôleur ==
Dans le code du noyau Joomla, il existe une classe capable de gérer les contrôleurs : ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html JControllerLegacy]''. Cette classe doit être étendue afin d'être utilisée dans notre composant. Dans le fichier <tt>votresite/components/com_helloworld/helloworld.php</tt> (point d'entrée de notre composant ''Hello World''), ajoutez ces lignes :

{{vanchor|site/helloworld.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

// Get an instance of the controller prefixed by HelloWorld
$controller = JControllerLegacy::getInstance('HelloWorld');

// Perform the Request task
$input = JFactory::getApplication()->input;
$controller->execute($input->getCmd('task'));

// Redirect if set by the controller
$controller->redirect();

</source>

La méthode statique ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html#method_getInstance getInstance]'' de la classe ''JControllerLegacy'' va créer un contrôleur. Dans le code ci-dessus, cela va instancier un objet contrôleur de la classe nommée ''HelloWorldController''. Joomla va chercher la déclaration de cette classe dans un fichier nommé <tt>votresitee/components/com_helloworld/controller.php</tt> (c'est un comportement par défaut).

Maintenant, <tt>controller.php</tt> doit être créé et "HelloWorldController" doit être déclaré et défini. A l'aide de votre gestionnaire de fichiers et éditeur préférés, créez un fichier <tt>votresite/components/com_helloworld/controller.php</tt> contenant :

{{vanchor|site/controller.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* Hello World Component Controller
*
* @since 0.0.1
*/
class HelloWorldController extends JControllerLegacy
{
}
</source>

Si aucune tâche (''task'') n'est indiquée dans les variables de requête, la tâche par défaut sera exécutée. Par défaut, la tâche ''display''. La classe ''JControllerLegacy'' possède une telle tâche. Dans notre exemple, elle affichera une vue nommée ''HelloWorld''.

Ainsi, avec tout simplement ''task'', une fonction publique display() de ''JControllerLegacy'' est référencée.

{{tip|Aparté : vous pourriez appeler une autre fonction adjointe à ''display()'' en utilisant une URL comme celle-ci :

<pre>http://localhost/index.php?option=com_helloworld&task=insert</pre>

Ceci va appeler une fonction ''insert()'' de notre contrôleur (que nous devrons implémenter dans ''HelloWorldController'' ).}}

== Configurer la vue ==
Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>.

Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/components/com_helloworld/views/helloworld/</tt>.

The file that will contain the code of the view is called <tt>view.[view_mode].php</tt>. The default view mode, and probably the only view a component might need is the ''html'' mode. So this give us our file name which is <tt>view.html.php</tt>.

With your favorite file manager and editor, '''create a file <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HTML View class for the HelloWorld Component
*
* @since 0.0.1
*/
class HelloWorldViewHelloWorld extends JViewLegacy
{
/**
* Display the Hello World view
*
* @param string $tpl The name of the template file to parse; automatically searches through the template paths.
*
* @return void
*/
function display($tpl = null)
{
// Assign data to the view
$this->msg = 'Hello World';

// Display the view
parent::display($tpl);
}
}

</source>

The ''display'' method of the ''[https://api.joomla.org/cms-3/classes/JViewLegacy.html JViewLegacy]'' class is called with the ''display'' task of the JControllerLegacy class. In our case, this method will display data using the ''tmpl/default.php'' file. With your favorite file manager and editor, create a file '''<tt>yoursite/components/com_helloworld/views/helloworld/tmpl/default.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');
?>
<h1><?php echo $this->msg; ?></h1>

</source>

This template file will be included by the JViewLegacy class. Therefore, here, $this refers to the HelloWorldViewHelloWorld class.

So to give an example, one could call the view inside the ''yoursite/components/com_[component_name]/views/[name of view]/'' folder by calling <code>index.php?option=com_helloworld</code> (this would default to the <tt>yoursite/components/com_helloworld/views/helloworld/</tt> folder) or we could explicitly call the folder by calling:

<code>index.php?option=com_helloworld&view=helloworld</code>

if we change <code>&view=helloworld</code> to something else, e.g. <code>&view=fluffy</code> we would have to create a folder <code>components/com_helloworld/views/fluffy/</code>.

Copy the contents of <code>views/helloworld</code> to <code>views/fluffy</code>

The classname of the file <code>view.html.php</code> of the fluffy folder would be ''HelloWorldViewFluffy''. Afterwards you can customize the contents of ''default.php'' of the ''fluffy'' subfolder for custom output and see the output by calling <code>index.php?option=com_helloworld&view=fluffy</code>

== Empaqueter le composant ==
Contenu de votre répertoire de code
* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-2-adding-a-site-view.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez tester ce composant simple en indiquant ''index.php?option=com_helloworld'' dans la barre d'adresse de votre navigateur.

<span id="helloworld.xml">
<tt>helloworld.xml</tt>
<source lang="xml" highlight="13,30,31">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>December 2013</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.2</version>

<description>Description of the Hello World component ...</description>

<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>
</files>
</administration>

</extension>
</source>
</span>

'''Résultat :'''
Vous verrez par défaut le message contenu dans la variable ''$this->msg'' du fichier <tt>view.html.php</tt>.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

==Contributeurs==
*[[User:Gunjanpatel|Gunjan Patel]]
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:Scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Developing_a_Basic_Component|Préc. : Développement d'un composant simple|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_a_menu_type_to_the_site_part|Suiv : Ajout d'un type de menu à la partie site|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Adding a view to the site part/23/fr

2015-07-20T08:48:33Z

Perete:

Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/components/com_helloworld/views/helloworld/</tt>.

J3.x:Developing an MVC Component/Adding a view to the site part/fr

2015-07-20T08:47:21Z

Perete: Created page with "Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/composants/com_helloworld/vues/helloworld/</tt>."

<noinclude><languages /></noinclude>
{{review}}
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.
Dans le framework Joomla! 3.x, les auteurs des composants tiers ont divisé leur code en trois parties principales:
* ''modèles'' : ils gèrent les données
* ''contrôleurs'' : ils exécutent les tâches, définissent et récupèrent les états des modèles et demandent aux vues de s'afficher
* ''vues'' : elles affichent le contenu en fonction du type (''error'', ''feed'', ''html'', ''json'', ''raw'', ''xml'') et la mise en page choisie par les contrôleurs.
== Configurer le contrôleur ==
Dans le code du noyau Joomla, il existe une classe capable de gérer les contrôleurs : ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html JControllerLegacy]''. Cette classe doit être étendue afin d'être utilisée dans notre composant. Dans le fichier <tt>votresite/components/com_helloworld/helloworld.php</tt> (point d'entrée de notre composant ''Hello World''), ajoutez ces lignes :

{{vanchor|site/helloworld.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

// Get an instance of the controller prefixed by HelloWorld
$controller = JControllerLegacy::getInstance('HelloWorld');

// Perform the Request task
$input = JFactory::getApplication()->input;
$controller->execute($input->getCmd('task'));

// Redirect if set by the controller
$controller->redirect();

</source>

La méthode statique ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html#method_getInstance getInstance]'' de la classe ''JControllerLegacy'' va créer un contrôleur. Dans le code ci-dessus, cela va instancier un objet contrôleur de la classe nommée ''HelloWorldController''. Joomla va chercher la déclaration de cette classe dans un fichier nommé <tt>votresitee/components/com_helloworld/controller.php</tt> (c'est un comportement par défaut).

Maintenant, <tt>controller.php</tt> doit être créé et "HelloWorldController" doit être déclaré et défini. A l'aide de votre gestionnaire de fichiers et éditeur préférés, créez un fichier <tt>votresite/components/com_helloworld/controller.php</tt> contenant :

{{vanchor|site/controller.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* Hello World Component Controller
*
* @since 0.0.1
*/
class HelloWorldController extends JControllerLegacy
{
}
</source>

Si aucune tâche (''task'') n'est indiquée dans les variables de requête, la tâche par défaut sera exécutée. Par défaut, la tâche ''display''. La classe ''JControllerLegacy'' possède une telle tâche. Dans notre exemple, elle affichera une vue nommée ''HelloWorld''.

Ainsi, avec tout simplement ''task'', une fonction publique display() de ''JControllerLegacy'' est référencée.

{{tip|Aparté : vous pourriez appeler une autre fonction adjointe à ''display()'' en utilisant une URL comme celle-ci :

<pre>http://localhost/index.php?option=com_helloworld&task=insert</pre>

Ceci va appeler une fonction ''insert()'' de notre contrôleur (que nous devrons implémenter dans ''HelloWorldController'' ).}}

== Configurer la vue ==
Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>.

Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/composants/com_helloworld/vues/helloworld/</tt>.

The file that will contain the code of the view is called <tt>view.[view_mode].php</tt>. The default view mode, and probably the only view a component might need is the ''html'' mode. So this give us our file name which is <tt>view.html.php</tt>.

With your favorite file manager and editor, '''create a file <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HTML View class for the HelloWorld Component
*
* @since 0.0.1
*/
class HelloWorldViewHelloWorld extends JViewLegacy
{
/**
* Display the Hello World view
*
* @param string $tpl The name of the template file to parse; automatically searches through the template paths.
*
* @return void
*/
function display($tpl = null)
{
// Assign data to the view
$this->msg = 'Hello World';

// Display the view
parent::display($tpl);
}
}

</source>

The ''display'' method of the ''[https://api.joomla.org/cms-3/classes/JViewLegacy.html JViewLegacy]'' class is called with the ''display'' task of the JControllerLegacy class. In our case, this method will display data using the ''tmpl/default.php'' file. With your favorite file manager and editor, create a file '''<tt>yoursite/components/com_helloworld/views/helloworld/tmpl/default.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');
?>
<h1><?php echo $this->msg; ?></h1>

</source>

This template file will be included by the JViewLegacy class. Therefore, here, $this refers to the HelloWorldViewHelloWorld class.

So to give an example, one could call the view inside the ''yoursite/components/com_[component_name]/views/[name of view]/'' folder by calling <code>index.php?option=com_helloworld</code> (this would default to the <tt>yoursite/components/com_helloworld/views/helloworld/</tt> folder) or we could explicitly call the folder by calling:

<code>index.php?option=com_helloworld&view=helloworld</code>

if we change <code>&view=helloworld</code> to something else, e.g. <code>&view=fluffy</code> we would have to create a folder <code>components/com_helloworld/views/fluffy/</code>.

Copy the contents of <code>views/helloworld</code> to <code>views/fluffy</code>

The classname of the file <code>view.html.php</code> of the fluffy folder would be ''HelloWorldViewFluffy''. Afterwards you can customize the contents of ''default.php'' of the ''fluffy'' subfolder for custom output and see the output by calling <code>index.php?option=com_helloworld&view=fluffy</code>

== Empaqueter le composant ==
Contenu de votre répertoire de code
* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-2-adding-a-site-view.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez tester ce composant simple en indiquant ''index.php?option=com_helloworld'' dans la barre d'adresse de votre navigateur.

<span id="helloworld.xml">
<tt>helloworld.xml</tt>
<source lang="xml" highlight="13,30,31">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>December 2013</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.2</version>

<description>Description of the Hello World component ...</description>

<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>
</files>
</administration>

</extension>
</source>
</span>

'''Résultat :'''
Vous verrez par défaut le message contenu dans la variable ''$this->msg'' du fichier <tt>view.html.php</tt>.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

==Contributeurs==
*[[User:Gunjanpatel|Gunjan Patel]]
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:Scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Developing_a_Basic_Component|Préc. : Développement d'un composant simple|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_a_menu_type_to_the_site_part|Suiv : Ajout d'un type de menu à la partie site|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Adding a view to the site part/23/fr

2015-07-20T08:47:21Z

Perete: Created page with "Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/composants/com_helloworld/vues/helloworld/</tt>."

Le nom du dossier de la vue par défaut est le nom du composant lui-même. Dans notre cas, le chemin est <tt>votresite/composants/com_helloworld/vues/helloworld/</tt>.

J3.x:Developing an MVC Component/Adding a view to the site part/fr

2015-07-20T08:44:48Z

Perete: Created page with "Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>."

<noinclude><languages /></noinclude>
{{review}}
{{:J3.1:Developing an MVC Component/fr}}
==Introduction==
Ce didacticiel fait partie de la série de didacticiels sur le [[S:MyLanguage/J3.2:Developing an MVC Component|Développement d'un Composant MVC pour Joomla! 3.x]]. Vous êtes invité à lire les articles précédents de cette série avant de lire celui-ci.
Dans le framework Joomla! 3.x, les auteurs des composants tiers ont divisé leur code en trois parties principales:
* ''modèles'' : ils gèrent les données
* ''contrôleurs'' : ils exécutent les tâches, définissent et récupèrent les états des modèles et demandent aux vues de s'afficher
* ''vues'' : elles affichent le contenu en fonction du type (''error'', ''feed'', ''html'', ''json'', ''raw'', ''xml'') et la mise en page choisie par les contrôleurs.
== Configurer le contrôleur ==
Dans le code du noyau Joomla, il existe une classe capable de gérer les contrôleurs : ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html JControllerLegacy]''. Cette classe doit être étendue afin d'être utilisée dans notre composant. Dans le fichier <tt>votresite/components/com_helloworld/helloworld.php</tt> (point d'entrée de notre composant ''Hello World''), ajoutez ces lignes :

{{vanchor|site/helloworld.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

// Get an instance of the controller prefixed by HelloWorld
$controller = JControllerLegacy::getInstance('HelloWorld');

// Perform the Request task
$input = JFactory::getApplication()->input;
$controller->execute($input->getCmd('task'));

// Redirect if set by the controller
$controller->redirect();

</source>

La méthode statique ''[https://api.joomla.org/cms-3/classes/JControllerLegacy.html#method_getInstance getInstance]'' de la classe ''JControllerLegacy'' va créer un contrôleur. Dans le code ci-dessus, cela va instancier un objet contrôleur de la classe nommée ''HelloWorldController''. Joomla va chercher la déclaration de cette classe dans un fichier nommé <tt>votresitee/components/com_helloworld/controller.php</tt> (c'est un comportement par défaut).

Maintenant, <tt>controller.php</tt> doit être créé et "HelloWorldController" doit être déclaré et défini. A l'aide de votre gestionnaire de fichiers et éditeur préférés, créez un fichier <tt>votresite/components/com_helloworld/controller.php</tt> contenant :

{{vanchor|site/controller.php}}
<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* Hello World Component Controller
*
* @since 0.0.1
*/
class HelloWorldController extends JControllerLegacy
{
}
</source>

Si aucune tâche (''task'') n'est indiquée dans les variables de requête, la tâche par défaut sera exécutée. Par défaut, la tâche ''display''. La classe ''JControllerLegacy'' possède une telle tâche. Dans notre exemple, elle affichera une vue nommée ''HelloWorld''.

Ainsi, avec tout simplement ''task'', une fonction publique display() de ''JControllerLegacy'' est référencée.

{{tip|Aparté : vous pourriez appeler une autre fonction adjointe à ''display()'' en utilisant une URL comme celle-ci :

<pre>http://localhost/index.php?option=com_helloworld&task=insert</pre>

Ceci va appeler une fonction ''insert()'' de notre contrôleur (que nous devrons implémenter dans ''HelloWorldController'' ).}}

== Configurer la vue ==
Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>.

The name of the folder of the default view is the name of the component itself. In our case the path is <tt>yoursite/components/com_helloworld/views/helloworld/</tt>.

The file that will contain the code of the view is called <tt>view.[view_mode].php</tt>. The default view mode, and probably the only view a component might need is the ''html'' mode. So this give us our file name which is <tt>view.html.php</tt>.

With your favorite file manager and editor, '''create a file <tt>yoursite/components/com_helloworld/views/helloworld/view.html.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');

/**
* HTML View class for the HelloWorld Component
*
* @since 0.0.1
*/
class HelloWorldViewHelloWorld extends JViewLegacy
{
/**
* Display the Hello World view
*
* @param string $tpl The name of the template file to parse; automatically searches through the template paths.
*
* @return void
*/
function display($tpl = null)
{
// Assign data to the view
$this->msg = 'Hello World';

// Display the view
parent::display($tpl);
}
}

</source>

The ''display'' method of the ''[https://api.joomla.org/cms-3/classes/JViewLegacy.html JViewLegacy]'' class is called with the ''display'' task of the JControllerLegacy class. In our case, this method will display data using the ''tmpl/default.php'' file. With your favorite file manager and editor, create a file '''<tt>yoursite/components/com_helloworld/views/helloworld/tmpl/default.php</tt>''' able to display the default view and containing:

<source lang="php">
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/

// No direct access to this file
defined('_JEXEC') or die('Restricted access');
?>
<h1><?php echo $this->msg; ?></h1>

</source>

This template file will be included by the JViewLegacy class. Therefore, here, $this refers to the HelloWorldViewHelloWorld class.

So to give an example, one could call the view inside the ''yoursite/components/com_[component_name]/views/[name of view]/'' folder by calling <code>index.php?option=com_helloworld</code> (this would default to the <tt>yoursite/components/com_helloworld/views/helloworld/</tt> folder) or we could explicitly call the folder by calling:

<code>index.php?option=com_helloworld&view=helloworld</code>

if we change <code>&view=helloworld</code> to something else, e.g. <code>&view=fluffy</code> we would have to create a folder <code>components/com_helloworld/views/fluffy/</code>.

Copy the contents of <code>views/helloworld</code> to <code>views/fluffy</code>

The classname of the file <code>view.html.php</code> of the fluffy folder would be ''HelloWorldViewFluffy''. Afterwards you can customize the contents of ''default.php'' of the ''fluffy'' subfolder for custom output and see the output by calling <code>index.php?option=com_helloworld&view=fluffy</code>

== Empaqueter le composant ==
Contenu de votre répertoire de code
* ''[[#helloworld.xml|helloworld.xml]]''
* ''[[#site/helloworld.php|site/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]''
* ''[[#site/controller.php|site/controller.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]''
* ''[[#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]''
* ''[[#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/helloworld.php|admin/helloworld.php]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]''
* ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]''

Créez un fichier compressé de ce répertoire ou téléchargez directement l'[https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-2-adding-a-site-view.zip archive] et installez-le en utilisant le gestionnaire des extensions Joomla. Vous pouvez tester ce composant simple en indiquant ''index.php?option=com_helloworld'' dans la barre d'adresse de votre navigateur.

<span id="helloworld.xml">
<tt>helloworld.xml</tt>
<source lang="xml" highlight="13,30,31">
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">

<name>Hello World!</name>

<creationDate>December 2013</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>

<version>0.0.2</version>

<description>Description of the Hello World component ...</description>

<update> 
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>



<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
</files>

<administration>

<menu link='index.php?option=com_helloworld'>Hello World!</menu>


<files folder="admin">

<filename>index.html</filename>
<filename>helloworld.php</filename>

<folder>sql</folder>
</files>
</administration>

</extension>
</source>
</span>

'''Résultat :'''
Vous verrez par défaut le message contenu dans la variable ''$this->msg'' du fichier <tt>view.html.php</tt>.

{{notice|Merci de créer un pull request ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.}}

==Contributeurs==
*[[User:Gunjanpatel|Gunjan Patel]]
*[[User:cdemko|Christophe Demko]]
*[[User:oaksu|Ozgur Aksu]]
*[[User:Scionescire|Scionescire]]

<div class="row">
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Developing_a_Basic_Component|Préc. : Développement d'un composant simple|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding_a_menu_type_to_the_site_part|Suiv : Ajout d'un type de menu à la partie site|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x/fr|Joomla! 3.x]]
[[Category:Joomla! 3.0/fr|Joomla! 3.0]]
[[Category:Joomla! 3.1/fr|Joomla! 3.1]]
[[Category:Joomla! 3.2/fr|Joomla! 3.2]]
[[Category:Joomla! 3.3/fr|Joomla! 3.3]]
[[Category:Joomla! 3.4/fr|Joomla! 3.4]]
[[Category:Beginner Development/fr|Développement pour débutants]]
[[Category:Component Development/fr|Développement de composants]]
[[Category:Tutorials/fr|Didacticiels]]
[[Category:Tutorials in a Series/fr|Didacticiels en série]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Adding a view to the site part/22/fr

2015-07-20T08:44:47Z

Perete: Created page with "Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>."

Lorsque JControllerLegacy veut afficher une vue, il va chercher les fichiers dans le dossier : <tt>votresite/components/com_[nom du composant]/views/[nom de la vue]/</tt>.

J3.x:Developing an MVC Component/Adding a variable request in the menu type/fr

2015-07-20T08:30:39Z

Perete:

Translations:J3.x:Developing an MVC Component/Adding a variable request in the menu type/13/fr

2015-07-20T08:30:38Z

Perete:

Merci de créer une demande ou un rapport d'anomalie sur https://github.com/joomla/Joomla-3.2-Hello-World-Component pour toute incohérence dans le code ou pour modifier le code source de cette page.

J3.x:Developing an MVC Component/Adding a variable request in the menu type/fr

2015-07-20T08:06:30Z

Perete:

Translations:J3.x:Developing an MVC Component/Adding a variable request in the menu type/10/fr

2015-07-20T08:06:30Z

Perete:

Vous pouvez tester l'affichage de cette variable en saisissant <tt>index.php?option=com_helloworld&id=1</tt> ou <tt>index. php?option=com_helloworld&id=2</tt> dans la barre d'adresse de votre navigateur.

J3.x:Developing an MVC Component/Adding a variable request in the menu type/fr

2015-07-20T08:05:27Z

Perete: Created page with "Vous pouvez tester l'affichage de cette variable en saisissant <tt>index.le php?option=com_helloworld&id=1</tt> ou <tt>index. php?option=com_helloworld&id=2</tt> dans la barre..."

Translations:J3.x:Developing an MVC Component/Adding a variable request in the menu type/10/fr

2015-07-20T08:05:26Z

Vous pouvez tester l'affichage de cette variable en saisissant <tt>index.le php?option=com_helloworld&id=1</tt> ou <tt>index. php?option=com_helloworld&id=2</tt> dans la barre d'adresse de votre navigateur.

J3.x:Developing an MVC Component/Adding a variable request in the menu type/fr

2015-07-20T07:59:39Z

Perete: Created page with "Modifiez également votre fichier <tt>helloworld.xml</tt> afin d'indiquer une nouvelle version :"

Translations:J3.x:Developing an MVC Component/Adding a variable request in the menu type/9/fr

2015-07-20T07:59:39Z

Perete: Created page with "Modifiez également votre fichier <tt>helloworld.xml</tt> afin d'indiquer une nouvelle version :"

Modifiez également votre fichier <tt>helloworld.xml</tt> afin d'indiquer une nouvelle version :

J3.x:Developing an MVC Component/Adding a variable request in the menu type/fr

2015-07-20T07:56:39Z

Perete: Created page with "Le modèle doit être modifié afin de permettre le choix entre les deux messages différents (ce choix s'effectue par l'utilisateur avec le champ défini ci-dessus):"

Translations:J3.x:Developing an MVC Component/Adding a variable request in the menu type/8/fr

2015-07-20T07:56:39Z

Perete: Created page with "Le modèle doit être modifié afin de permettre le choix entre les deux messages différents (ce choix s'effectue par l'utilisateur avec le champ défini ci-dessus):"

Le modèle doit être modifié afin de permettre le choix entre les deux messages différents (ce choix s'effectue par l'utilisateur avec le champ défini ci-dessus):

J3.x:Developing an MVC Component/Adding a variable request in the menu type/fr

2015-07-20T07:51:52Z

Perete: Created page with "* le nom de l'attribut peut être transmis à la composante dans l'URL. Dans ce cas <tt>?option=com_helloworld&id=1</tt> indiquerait que vous avez choisi l'option 1."

Translations:J3.x:Developing an MVC Component/Adding a variable request in the menu type/7/fr

2015-07-20T07:51:51Z

Perete: Created page with "* le nom de l'attribut peut être transmis à la composante dans l'URL. Dans ce cas <tt>?option=com_helloworld&id=1</tt> indiquerait que vous avez choisi l'option 1."

* le nom de l'attribut peut être transmis à la composante dans l'URL. Dans ce cas <tt>?option=com_helloworld&id=1</tt> indiquerait que vous avez choisi l'option 1.