Joomla! Documentation - User contributions [en]

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

2024-10-22T14:45:52Z

Vomoa: Created page with "Die Versionskennung für das Datenbankschema und die Versionskennung der Komponente müssen nicht identisch sein. Joomla übernimmt die Versionskennung für das Datenbankschem..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Dies kann durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] erreicht werden (gültig seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden: Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Die Versionskennung für das Datenbankschema und die Versionskennung der Komponente müssen nicht identisch sein. Joomla übernimmt die Versionskennung für das Datenbankschema aus dem Namen der Aktualisierungsdatei mit der höchsten Versionskennung. Deshalb wird empfohlen, dass es immer eine Aktualisierungsdatei gibt, sebst dann, wenn sie keinen Inhalt hat.
Wenn es erreicht werden soll, dass die Versionskennung für das Datenbankschema und die Versionskennung der Komponente immer identisch ist, dann kann folgende Vorgehensweise empfohlen werden: Soll der Code aktualisiert werden, dann kann eine Aktualisierungsdatei mit neuer Versionsnummer hinzugefügt werden, hier bei wird die Aktualisierungsdatei leer sein.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Hinzufügen eines neuen Feldtyps ==
Bisher haben wir einen Feldtyp für die Nachricht verwendet, welcher statisch vorgegeben war, siehe [S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part]. Jetzt möchten wird die Datenbank verwenden, um die Nachricht auszuwählen und hierfür müssen wir einen benutzerspezifischen Feldtyp mit der Bezeichnung "helloworld" definieren, siehe hierzu [S:MyLanguage/Creating_a_custom_form_field_type].

Die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> muss bearbeitet werden und um folgende Zeilen ergänzt werden:

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

Dieser Code führt einen neuen Feldtyp ein und gibt Joomla die Anweisung die Definition des Feldes im Ordner <tt>/administrator/components/com_helloworld/models/fields</tt> zu verwenden.

Es gibt ein weiteres Tutorial, um mehr über Datenbankabfragen zu lernen. Hier wird erklärt wie Daten aus einer Datenbanktabelle in verschiedenen Formaten gelesen werden können: [[S:MyLanguage/Selecting_data_using_JDatabase|hier klicken]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/38/de

2024-10-22T14:45:52Z

Die Versionskennung für das Datenbankschema und die Versionskennung der Komponente müssen nicht identisch sein. Joomla übernimmt die Versionskennung für das Datenbankschema aus dem Namen der Aktualisierungsdatei mit der höchsten Versionskennung. Deshalb wird empfohlen, dass es immer eine Aktualisierungsdatei gibt, sebst dann, wenn sie keinen Inhalt hat.
Wenn es erreicht werden soll, dass die Versionskennung für das Datenbankschema und die Versionskennung der Komponente immer identisch ist, dann kann folgende Vorgehensweise empfohlen werden: Soll der Code aktualisiert werden, dann kann eine Aktualisierungsdatei mit neuer Versionsnummer hinzugefügt werden, hier bei wird die Aktualisierungsdatei leer sein.

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

2024-10-22T14:34:39Z

Vomoa:

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Dies kann durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] erreicht werden (gültig seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden: Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Hinzufügen eines neuen Feldtyps ==
Bisher haben wir einen Feldtyp für die Nachricht verwendet, welcher statisch vorgegeben war, siehe [S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part]. Jetzt möchten wird die Datenbank verwenden, um die Nachricht auszuwählen und hierfür müssen wir einen benutzerspezifischen Feldtyp mit der Bezeichnung "helloworld" definieren, siehe hierzu [S:MyLanguage/Creating_a_custom_form_field_type].

Die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> muss bearbeitet werden und um folgende Zeilen ergänzt werden:

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

Dieser Code führt einen neuen Feldtyp ein und gibt Joomla die Anweisung die Definition des Feldes im Ordner <tt>/administrator/components/com_helloworld/models/fields</tt> zu verwenden.

Es gibt ein weiteres Tutorial, um mehr über Datenbankabfragen zu lernen. Hier wird erklärt wie Daten aus einer Datenbanktabelle in verschiedenen Formaten gelesen werden können: [[S:MyLanguage/Selecting_data_using_JDatabase|hier klicken]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/37/de

2024-10-22T14:34:38Z

Vomoa:

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden: Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

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

2024-10-21T12:46:10Z

Vomoa: Created page with "Es gibt ein weiteres Tutorial, um mehr über Datenbankabfragen zu lernen. Hier wird erklärt wie Daten aus einer Datenbanktabelle in verschiedenen Formaten gelesen werden kön..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Dies kann durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] erreicht werden (gültig seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Hinzufügen eines neuen Feldtyps ==
Bisher haben wir einen Feldtyp für die Nachricht verwendet, welcher statisch vorgegeben war, siehe [S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part]. Jetzt möchten wird die Datenbank verwenden, um die Nachricht auszuwählen und hierfür müssen wir einen benutzerspezifischen Feldtyp mit der Bezeichnung "helloworld" definieren, siehe hierzu [S:MyLanguage/Creating_a_custom_form_field_type].

Die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> muss bearbeitet werden und um folgende Zeilen ergänzt werden:

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

Dieser Code führt einen neuen Feldtyp ein und gibt Joomla die Anweisung die Definition des Feldes im Ordner <tt>/administrator/components/com_helloworld/models/fields</tt> zu verwenden.

Es gibt ein weiteres Tutorial, um mehr über Datenbankabfragen zu lernen. Hier wird erklärt wie Daten aus einer Datenbanktabelle in verschiedenen Formaten gelesen werden können: [[S:MyLanguage/Selecting_data_using_JDatabase|hier klicken]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

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

2024-10-21T12:46:08Z

Es gibt ein weiteres Tutorial, um mehr über Datenbankabfragen zu lernen. Hier wird erklärt wie Daten aus einer Datenbanktabelle in verschiedenen Formaten gelesen werden können: [[S:MyLanguage/Selecting_data_using_JDatabase|hier klicken]].

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

2024-10-21T12:40:55Z

Vomoa: Created page with "Dieser Code führt einen neuen Feldtyp ein und gibt Joomla die Anweisung die Definition des Feldes im Ordner <tt>/administrator/components/com_helloworld/models/fields</tt> zu..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Dies kann durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] erreicht werden (gültig seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Hinzufügen eines neuen Feldtyps ==
Bisher haben wir einen Feldtyp für die Nachricht verwendet, welcher statisch vorgegeben war, siehe [S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part]. Jetzt möchten wird die Datenbank verwenden, um die Nachricht auszuwählen und hierfür müssen wir einen benutzerspezifischen Feldtyp mit der Bezeichnung "helloworld" definieren, siehe hierzu [S:MyLanguage/Creating_a_custom_form_field_type].

Die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> muss bearbeitet werden und um folgende Zeilen ergänzt werden:

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

Dieser Code führt einen neuen Feldtyp ein und gibt Joomla die Anweisung die Definition des Feldes im Ordner <tt>/administrator/components/com_helloworld/models/fields</tt> zu verwenden.

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

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

2024-10-21T12:40:53Z

Dieser Code führt einen neuen Feldtyp ein und gibt Joomla die Anweisung die Definition des Feldes im Ordner <tt>/administrator/components/com_helloworld/models/fields</tt> zu verwenden.

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

2024-10-21T12:37:31Z

Vomoa:

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Dies kann durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] erreicht werden (gültig seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Hinzufügen eines neuen Feldtyps ==
Bisher haben wir einen Feldtyp für die Nachricht verwendet, welcher statisch vorgegeben war, siehe [S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part]. Jetzt möchten wird die Datenbank verwenden, um die Nachricht auszuwählen und hierfür müssen wir einen benutzerspezifischen Feldtyp mit der Bezeichnung "helloworld" definieren, siehe hierzu [S:MyLanguage/Creating_a_custom_form_field_type].

Die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> muss bearbeitet werden und um folgende Zeilen ergänzt werden:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

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

2024-10-21T12:37:30Z

Vomoa:

Die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> muss bearbeitet werden und um folgende Zeilen ergänzt werden:

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

2024-10-21T12:36:48Z

Vomoa: Created page with "Bisher haben wir einen Feldtyp für die Nachricht verwendet, welcher statisch vorgegeben war, siehe [S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the si..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Dies kann durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] erreicht werden (gültig seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Hinzufügen eines neuen Feldtyps ==
Bisher haben wir einen Feldtyp für die Nachricht verwendet, welcher statisch vorgegeben war, siehe [S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part]. Jetzt möchten wird die Datenbank verwenden, um die Nachricht auszuwählen und hierfür müssen wir einen benutzerspezifischen Feldtyp mit der Bezeichnung "helloworld" definieren, siehe hierzu [S:MyLanguage/Creating_a_custom_form_field_type].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

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

2024-10-21T12:36:47Z

Bisher haben wir einen Feldtyp für die Nachricht verwendet, welcher statisch vorgegeben war, siehe [S:MyLanguage/J3.3:Developing an MVC Component/Adding a menu type to the site part]. Jetzt möchten wird die Datenbank verwenden, um die Nachricht auszuwählen und hierfür müssen wir einen benutzerspezifischen Feldtyp mit der Bezeichnung "helloworld" definieren, siehe hierzu [S:MyLanguage/Creating_a_custom_form_field_type].

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

2024-10-21T12:26:19Z

Vomoa: Created page with "== Hinzufügen eines neuen Feldtyps =="

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Dies kann durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] erreicht werden (gültig seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Hinzufügen eines neuen Feldtyps ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/13/de

2024-10-21T12:26:19Z

Vomoa: Created page with "== Hinzufügen eines neuen Feldtyps =="

== Hinzufügen eines neuen Feldtyps ==

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

2024-10-21T12:25:36Z

Vomoa:

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Dies kann durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] erreicht werden (gültig seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/46/de

2024-10-21T12:25:35Z

Vomoa:

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Dies kann durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] erreicht werden (gültig seit Joomla 3.4.0).

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

2024-10-21T12:23:34Z

Vomoa: Created page with "Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der V..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/45/de

2024-10-21T12:23:32Z

Es ist im Allgemeinen ratsam, dem Design-Muster von Joomla zu folgen. Dies ist von Vorteil bei der Wiederverwendung von zentralen Joomla-Javascript-Routinen, so auch bei der Verwendung von komplexeren Funktionalitäten, wie z.B. ACL (Access Control LIst - Zugriffskontrolliste) oder Verknüpfungen. Siehe hierzu auch weitere Folge dieses Tutorials (https://docs.joomla.org/Special:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_ACL, https://docs.joomla.org/J3.x:Developing_an_MVC_Component/Adding_Associations).
[Die Übersetzung dieses Absatzes wurde verallgemeinert, da die im Original beschriebene Datenbankstruktur so nicht mehr verwendet wird.]

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

2024-10-20T21:04:02Z

Vomoa:

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/37/de

2024-10-20T21:04:00Z

Vomoa:

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollte folgender Hinweis beachtet werden. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

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

2024-10-20T21:03:24Z

Vomoa:

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/37/de

2024-10-20T21:03:20Z

Vomoa:

Wenn bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

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

2024-10-20T21:02:43Z

Vomoa: Created page with "Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/36/de

2024-10-20T21:02:42Z

Wenn eine neuere Version dieser Komponente installiert wird - es muss nicht unbedingt die nächst höhere Version sein, es können Versionen übersprungen werden - Joomla wird folgede Schritte ausführen:
* Aus der Tabelle <tt>#__schemas</tt> wird die aktuelle Version des Datenbankschemas der Komponente gelesen - in unserem Beispiel entspricht diese dem Wert 0.0.6.
* Es werden die Dateinamen aller Dateien in dem Verzeichnis <tt>admin/sql/updates/mysql/</tt> gelesen und in numerisch aufsteigender Reihenfolge sortiert.
* Es werden die Aktualisierungsdateien der Dateinamen ausgeführt, wenn diese für eine höhere Schemaversion als die aktuelle Version gelten - es könnten z.B. die Dateien "0.0.7.sql", "0.0.9.sql" und "0.0.10.sql" gefunden werden, welche in dieser Reihenfolge ausgeführt weden.
* Es wird die Information über das Datenbankschema aktualisiert. Hierbei wird die Version der zuletzt ausgeführten Aktualisierungsdatei übernommen - z.B. 0.0.10.

Translations:J3.x:Developing an MVC Component/Using the database/30/de

2024-10-11T21:28:48Z

Vomoa: Created page with "S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend"

S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend

Translations:J3.x:Developing an MVC Component/Using the database/29/de

2024-10-11T21:28:41Z

Vomoa: Created page with "S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Prev: Adding a variable request in the menu type"

S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding a variable request in the menu type|Prev: Adding a variable request in the menu type

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

2024-10-11T21:25:30Z

Vomoa: Created page with "== Anzeige der gewählten Nachricht =="

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Anzeige der gewählten Nachricht ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/20/de

2024-10-11T21:25:28Z

Vomoa: Created page with "== Anzeige der gewählten Nachricht =="

== Anzeige der gewählten Nachricht ==

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

2024-10-11T21:21:06Z

Vomoa: Created page with "== Mitwirkende =="

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== Mitwirkende ==
*[[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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/42/de

2024-10-11T21:21:05Z

Vomoa: Created page with "== Mitwirkende =="

== Mitwirkende ==

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

2024-10-11T21:20:59Z

Vomoa: Created page with "Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschlä..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.}}

== 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/28/de

2024-10-11T21:20:59Z

Gerne kann ein Pull-Request oder ein Issue auf https://github.com/joomla/Joomla-3.2-Hello-World-Component erstellt werden, falls es Unstimmigkeiten oder Verbesserungsvorschläge für den auf dieser Seite dargestellten Quellcode gibt.

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

2024-10-11T21:16:10Z

Vomoa: Created page with "Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-us..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code discrepancies or if editing any of the source code on this 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/27/de

2024-10-11T21:16:09Z

Es kann eine komprimierte Datei aus diesem Verzeichnis erstellt werden oder diese direkt von [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] heruntergeladen werden. Die Datei kann dann über die Installation für Erweiterungen in Joomla installiert werden.
Es kann dann ein Menüpunkt dieser Komponente über den Menümanager im Backend hinzugefügt werden.

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

2024-10-11T21:08:55Z

Vomoa: Created page with "Inhalt des Verzeichnisses mit dem Code"

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Inhalt des Verzeichnisses mit dem 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]]''

Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.

{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code discrepancies or if editing any of the source code on this 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/26/de

2024-10-11T21:08:54Z

Vomoa: Created page with "Inhalt des Verzeichnisses mit dem Code"

Inhalt des Verzeichnisses mit dem Code

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

2024-10-11T21:08:15Z

Vomoa: Created page with "== Die Komponente zur Bereitstellung vorbereiten =="

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Die Komponente zur Bereitstellung vorbereiten ==

Content of your code directory

* ''[[#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]]''

Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.

{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code discrepancies or if editing any of the source code on this 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/25/de

2024-10-11T21:08:14Z

Vomoa: Created page with "== Die Komponente zur Bereitstellung vorbereiten =="

== Die Komponente zur Bereitstellung vorbereiten ==

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

2024-10-11T21:03:48Z

Vomoa: Created page with "Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenb..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Packaging the component ==

Content of your code directory

* ''[[#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]]''

Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.

{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code discrepancies or if editing any of the source code on this 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/37/de

2024-10-11T21:03:47Z

Wenn Sie bereits eine Versionen der Komponente ohne Datenbanknutzung veröffentlicht wurde, dann sollten sie folgenden Hinweis beachten. Mit der erstmaligen Nutzung der Datenbank durch die Komponente muss die Aktualisierungsdatei dann den gleichen Inhalt haben, wie die Installationsdatei.

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

2024-10-11T20:53:42Z

Vomoa: Created page with "Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

If you have already released versions of your component when you introduce database use, as we have simulated in this tutorial series, then your first update file must have exactly the same content as the install file. If you have not, then it should be empty.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Packaging the component ==

Content of your code directory

* ''[[#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]]''

Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.

{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code discrepancies or if editing any of the source code on this 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/35/de

2024-10-11T20:53:41Z

Joomla speichert die Version des Datenbankschemas der jeweiligen Komponente durch einen Datensatz in der Tabelle <tt>#__schemas</tt> wenn eine Komponente erstmalig installiert wird. Liegt z.B. eine Datei namens <tt>admin/sql/updates/mysql/0.0.6.sql</tt> vor, dann wird Joomla den Wert <tt>0.0.6</tt> in der Datenbank als Version speichern.

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

2024-10-11T10:23:40Z

Vomoa: Created page with "Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Kompone..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

Joomla keeps track of the database schema version of your component through a record in its <tt>#__schemas</tt> table. So when you first install a component, if there's a file called, say, <tt>admin/sql/updates/mysql/0.0.6.sql</tt>, then Joomla will store the value <tt>0.0.6</tt> it its schemas record.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

If you have already released versions of your component when you introduce database use, as we have simulated in this tutorial series, then your first update file must have exactly the same content as the install file. If you have not, then it should be empty.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Packaging the component ==

Content of your code directory

* ''[[#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]]''

Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.

{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code discrepancies or if editing any of the source code on this 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/34/de

2024-10-11T10:23:38Z

Die Komponente besitzt eine Versionsnummer (diese ist innerhalb des Tags <tt><version></tt> in der Manifestdatei helloword.xml angegeben). Das Schema der Datenbank der Komponente besitzt eine eigene Versionsnummer (diese basiert auf den Dateinamen der Sql-Update-Dateien).

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

2024-10-11T10:14:49Z

Vomoa: Created page with "Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'st..."

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Your component has a version number (which is specified inside the <tt><version></tt> tag in your helloword.xml manifest file), and your component's database schema has its own version number (which is based on the filenames of the sql update files).

Joomla keeps track of the database schema version of your component through a record in its <tt>#__schemas</tt> table. So when you first install a component, if there's a file called, say, <tt>admin/sql/updates/mysql/0.0.6.sql</tt>, then Joomla will store the value <tt>0.0.6</tt> it its schemas record.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

If you have already released versions of your component when you introduce database use, as we have simulated in this tutorial series, then your first update file must have exactly the same content as the install file. If you have not, then it should be empty.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Packaging the component ==

Content of your code directory

* ''[[#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]]''

Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.

{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code discrepancies or if editing any of the source code on this 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

Translations:J3.x:Developing an MVC Component/Using the database/46/de

2024-10-11T10:14:47Z

Oft gibt es in der Datenbanktabelle ein Feld, in dem der Veröffentlichungs- bzw. Nichtveröffentlichungsstatus eines Eintrags festgehalten wird. Die Verwendung des Namens 'state' innerhalb von Joomla wird nicht empfohlen, da dies zu Konflikten führen kann, stattdessen wird der Name 'published' verwendet. <br />
Hinweis: Wie kann man Joomla anweisen, den Wert des veröffentlichten Formularfeldes in einem Datenbankfeld mit einem anderen Namen zu speichern? Wir tun dies durch die Verwendung der Methode [[S:MyLanguage/Column alias|setColumnAlias()]] (seit Joomla 3.4.0).

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

2024-10-11T10:10:17Z

Vomoa: Created page with "Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:"

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Often you will find that the database table has a field to keep track of the published/unpublished state of an item. Using the name 'state' within Joomla is not recommended as it can lead to conflicts, instead the name 'published' is used.<br />
Note: How to tell Joomla to store the value of the published form field into a different name database field? We do this by using the method [[S:MyLanguage/Column alias|setColumnAlias()]] (since 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Your component has a version number (which is specified inside the <tt><version></tt> tag in your helloword.xml manifest file), and your component's database schema has its own version number (which is based on the filenames of the sql update files).

Joomla keeps track of the database schema version of your component through a record in its <tt>#__schemas</tt> table. So when you first install a component, if there's a file called, say, <tt>admin/sql/updates/mysql/0.0.6.sql</tt>, then Joomla will store the value <tt>0.0.6</tt> it its schemas record.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

If you have already released versions of your component when you introduce database use, as we have simulated in this tutorial series, then your first update file must have exactly the same content as the install file. If you have not, then it should be empty.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Packaging the component ==

Content of your code directory

* ''[[#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]]''

Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.

{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code discrepancies or if editing any of the source code on this 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

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

2024-10-11T10:10:16Z

Vomoa: Created page with "Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:"

Bearbeite die Datei <tt>site/views/helloworld/tmpl/default.xml</tt> und ergänze folgende Zeilen:

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

2024-10-11T10:09:21Z

Vomoa: Created page with "Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:"

<noinclude><languages /></noinclude>
{{:J3.1:Developing an MVC Component/de}}
== Einleitung ==
Dieses Tutorial ist ein Teil der Artikelserie mit Tutorials über [[S:MyLanguage/J3.3:Developing an MVC Component | Developing an MVC Component for Joomla! 3.3]]. Es wird empfohlen die vorherigen Teile des Tutorials zu lesen, bevor dieser Teil gelesen wird. Es wird auch empfohlen weitere Quellen über über Datenbankabfragen, die Auswahl von Daten aus einer Datenbanktabelle und das Abrufen von Daten in verschiedenen Formaten zu lesen.

Zu diesem Teil gibt es auch drei Videos:
- Setup der Datenbank [https://www.youtube.com/watch?v=JWS_3rx8RzY the Database Setup]
- Anzeigen der Nachricht (unter Verwendung von JTable) [https://www.youtube.com/watch?v=rKEHDeFGlGM Displaying the message (using JTable)]
- Auswahl der Nachricht im Admin-Bereich (unter Verwendung von JDatabase) [https://www.youtube.com/watch?v=uEDNyG6pSEk Admin message selection (and JDatabase)].

{{#widget:YouTube|id=JWS_3rx8RzY}}

{{#widget:YouTube|id=rKEHDeFGlGM}}

{{#widget:YouTube|id=uEDNyG6pSEk}}

== Verwendung der Datenbank ==
Komponenten verwalten ihren Inhalt in der Regel über die Datenbank. Während der Installations-/Deinstallations-/Aktualisierungsphase einer Komponente können SQL-Abfragen mithilfe von SQL-Textdateien ausgeführt werden.

Mit dem bevorzugten Dateimanager und Editor sollen zwei Dateien erstellt werden:
- <tt>admin/sql/install.mysql.utf8.sql</tt>
- <tt>admin/sql/updates/mysql/0.0.6.sql</tt>
Beide sollen den gleichen, folgenden Inhalt haben:

<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 DEFAULT '1',
PRIMARY KEY (`id`)
)
ENGINE =MyISAM
AUTO_INCREMENT =0
DEFAULT CHARSET =utf8;

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

</source>
</span>

""Anmerkung."" Für die aktuell verwendete Datenbankstruktur wird folgende Angabe empfohlen:

<tt>ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 DEFAULT COLLATE=utf8mb4_unicode_ci;</tt>

anstelle der oben genannten. InnoDB ist die modernere (und jetzt standardmäßige) MySQL-Datenbank-Engine, die MyISAM ersetzt, und mit dem Format utf8mb4 eine breitere Palette von Zeichensätzen einschließlich Emojis unterstützt. Es wurden jedoch nicht alle Teile des Tutorials mit dieser Einstellung getestet. Wenn die weiteren Teile der Tutorial-Serie durchgearbeitet und InnoDB verwendet wird, dann wird empfohlen diese Datei auch in den anderen Teilen des Tutorials zu aktualisieren.

Also note that if you look at a Joomla database many of the key database tables have a field called 'title' for the sort of information which we're storing in our 'greeting' field. It's generally advisable to follow the Joomla pattern, and use 'title' as the field name, as when we try to use more complex functionality (such as ACL and associations) some of the core Joomla javascript routines we want to reuse expect a 'title' field to be present. (Something to consider changing when this tutorial series is next updated).

Often you will find that the database table has a field to keep track of the published/unpublished state of an item. Using the name 'state' within Joomla is not recommended as it can lead to conflicts, instead the name 'published' is used.<br />
Note: How to tell Joomla to store the value of the published form field into a different name database field? We do this by using the method [[S:MyLanguage/Column alias|setColumnAlias()]] (since 3.4.0).

Die Datei <tt>install.mysql.utf8.sql</tt> wird ausgeführt, wenn diese Komponente installiert wird.
Die Datei <tt>updates/mysql/0.0.6.sql</tt> wird ausgeführt, wenn ein Update durchgeführt wird.

Damit die Installation bzw. das Update durchgeührt werden kann, müssen die entsprechenden Dateien in der Datei <tt>helloworld.xml</tt> angegeben werden.

'''Wichtiger Hinweis:''' Wenn die SQL-Dateien in utf8 gespeichert wird, dann muss sichergestellt werden, dass sie als utf8 NOT BOM gespeichert wird, ansonsten wird die Abfrage mit dem MySQL-Fehler #1064 fehlschlagen.

<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.0" method="upgrade">

<name>Hello World!</name>

<creationDate>January 2018</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>

Mit der Datei zur Deinstallation wird genau so verfahren:

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/sql/uninstall.mysql.utf8.sql</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Schematische Nummerierung ==

Your component has a version number (which is specified inside the <tt><version></tt> tag in your helloword.xml manifest file), and your component's database schema has its own version number (which is based on the filenames of the sql update files).

Joomla keeps track of the database schema version of your component through a record in its <tt>#__schemas</tt> table. So when you first install a component, if there's a file called, say, <tt>admin/sql/updates/mysql/0.0.6.sql</tt>, then Joomla will store the value <tt>0.0.6</tt> it its schemas record.

When you next install a newer version of this component - it doesn't have to be the next version, you can skip versions - Joomla will do the following:
* it will retrieve the component's latest database schema version from its <tt>#__schemas</tt> table - so it might find in our example the value 0.0.6.
* it will get the filenames of all the files in the <tt>admin/sql/updates/mysql/</tt> directory, and organise them in numerically increasing order.
* it will process in order the update files which have filenames numerically after the current schema version - so it might find files called 0.0.7.sql, 0.0.9.sql and 0.0.10.sql, and process these in order.
* it will update the schemas record to have the number of the last update file which it processed - eg 0.0.10.

If you have already released versions of your component when you introduce database use, as we have simulated in this tutorial series, then your first update file must have exactly the same content as the install file. If you have not, then it should be empty.

Although it may be a good idea to keep the two version numbers in step, you don't have to. Joomla takes the schema version from the name of the numerically last update file. That's why it is recommended that there should be an initial update file, even if it's empty. If you want to keep your schema numbers in step with the component version numbers when you update your code but not the database schema, you simply include an update file to go with the new release number, and that update file, too, will be empty.

As you make subsequent releases of your component the database install file must always contain the full schema and the update files only need to contain any changes you have made to the schema since the last update.

== Adding a new field type ==
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, and for this we need to define a custom field type (which we call ''helloworld'' below) as described [[S:MyLanguage/Creating_a_custom_form_field_type|here]].

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.

In order to learn more on database queries, selecting data from a database table and retrieving it in several formats [[S:MyLanguage/Selecting_data_using_JDatabase|click here]].
Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:

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

== Display the chosen message ==
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. To do this is uses the [https://docs.joomla.org/Using_the_JTable_class JTable] functionality, which is an alternative to JDatabase if only CRUD operations on single records are required.

Modify the <tt>site/models/helloworld.php</tt> file:

<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 - 2018 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 - 2018 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''.

== Packaging the component ==

Content of your code directory

* ''[[#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]]''

Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-6-using-the-database.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.

{{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code discrepancies or if editing any of the source code on this 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|Prev: Adding a variable request in the menu type|class=expand success}}</div>
<div class="large-6 columns">{{Basic button|S:MyLanguage/J3.x:Developing_an_MVC_Component/Basic backend|Next: Basic backend|class=expand}}</div>
</div>

<noinclude>
[[Category:Joomla! 3.x{{#translation:}}]]
[[Category:Joomla! 3.0{{#translation:}}]]
[[Category:Joomla! 3.1{{#translation:}}]]
[[Category:Joomla! 3.2{{#translation:}}]]
[[Category:Joomla! 3.3{{#translation:}}]]
[[Category:Joomla! 3.4{{#translation:}}]]
[[Category:Beginner Development{{#translation:}}]]
[[Category:Component Development{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:Tutorials in a Series{{#translation:}}]]
</noinclude>

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

2024-10-11T10:09:15Z

Vomoa: Created page with "Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält:"

Mit dem bevorzugten Dateimanager und Editor soll die Datei <tt>admin/models/fields/helloworld.php</tt> erstellt werden, die folgenden Inhalt enthält: