http://api.php?action=feedcontributions&user=Bembelimen&feedformat=atomJoomla! Dokumentation - Benutzerbeiträge [de]2012-05-20T05:49:01ZBenutzerbeiträgeMediaWiki 1.18.0http://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/writeJoomla! Programmierung/Framework/JFile/write2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/write“ nach „JFile/write“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/write]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/uploadJoomla! Programmierung/Framework/JFile/upload2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/upload“ nach „JFile/upload“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/upload]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/stripExtJoomla! Programmierung/Framework/JFile/stripExt2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/stripExt“ nach „JFile/stripExt“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/stripExt]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/readJoomla! Programmierung/Framework/JFile/read2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/read“ nach „JFile/read“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/read]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/moveJoomla! Programmierung/Framework/JFile/move2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/move“ nach „JFile/move“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/move]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/makeSafeJoomla! Programmierung/Framework/JFile/makeSafe2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/makeSafe“ nach „JFile/makeSafe“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/makeSafe]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/getNameJoomla! Programmierung/Framework/JFile/getName2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/getName“ nach „JFile/getName“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/getName]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/getExtJoomla! Programmierung/Framework/JFile/getExt2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/getExt“ nach „JFile/getExt“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/getExt]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/existsJoomla! Programmierung/Framework/JFile/exists2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/exists“ nach „JFile/exists“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/exists]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/deleteJoomla! Programmierung/Framework/JFile/delete2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/delete“ nach „JFile/delete“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/delete]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFile/copyJoomla! Programmierung/Framework/JFile/copy2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/copy“ nach „JFile/copy“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile/copy]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/getNameJFile/getName2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/getName“ nach „JFile/getName“: Struktur angepasst</p>
<hr />
<div>'''JFile::getName''' extrahiert aus einem kompletten Pfad den Dateinamen.<br />
<br />
==Syntax==<br />
<source lang="php">static getName( $file )</source><br />
* '''@return''' {{mark|string}} der Dateiname<br />
* '''@since''' {{JVer|1.5}}<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$file</tt><br />
|<tt>string</tt><br />
|Der komlette Pfad zur Datei<br />
| ---<br />
|}<br />
<br />
==Beispiel==<br />
<source lang="php"><br />
$pfad = 'pfad'.DS.'zur'.DS.'datei.php';<br />
<br />
echo JFile::getName($pfad);<br />
</source><br />
Ausgabe<br />
datei.php<br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#getName JFile->getName()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/getName</jcodedisplay><br />
<br />
[[Kategorie:Experten|getName]]<br />
[[Kategorie:Joomla! Programmierung|getName]]<br />
[[Kategorie:Framework|getName]]<br />
[[Kategorie:JFile|getName]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/existsJFile/exists2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/exists“ nach „JFile/exists“: Struktur angepasst</p>
<hr />
<div>'''JFile::exists''' führt die standard PHP Funktion [http://www.php.net/manual/en/function.file-exists.php file_exists] aus.<br />
<br />
==Syntax==<br />
<source lang="php">static exists( $file )</source><br />
* '''@return''' {{mark|boolean}} '''True''' wenn die Datei existiert<br />
* '''@since''' {{JVer|1.5}}<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$file</tt><br />
|<tt>string</tt><br />
|Pfad zur Datei<br />
|<br />
|}<br />
<br />
==Beispiel==<br />
<br />
=== Prüfen ob eine Datei existiert ===<br />
<source lang="php"><br />
if( JFile::exists(JPATH_ROOT.'/pfad/zur/datei.ext') )<br />
{<br />
echo 'Die Datei exisiert';<br />
}<br />
</source><br />
{{tip}} Da Joomla! automatisch die Trennzeichen für Verzeichnisse an das Betriebssystem anpasst, können wir hier auf die Benutzung der [[Joomla!_Programmierung/Framework/Konstanten|Konstante]] DS verzichten.<br />
<br />
Aus <tt>pfad/zur/datei</tt> wird also unter windows automatisch <tt>pfad\zur\datei</tt>.<br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#exists JFile->exists()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/exists</jcodedisplay><br />
<br />
[[Kategorie:Experten|exists]]<br />
[[Kategorie:Joomla! Programmierung|exists]]<br />
[[Kategorie:Framework|exists]]<br />
[[Kategorie:JFile|exists]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/uploadJFile/upload2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/upload“ nach „JFile/upload“: Struktur angepasst</p>
<hr />
<div>'''JFile::upload''' verschiebt eine hochgeladene Datei in ein Zielverzeichnis.<br />
<br />
==Syntax==<br />
<div style="float: left; padding: 0.3em;">{{JVer|1.5}}</div><br />
<source lang="php">static upload( $src, $dest )</source><br />
<div style="float: left; padding: 0.3em;">{{JVer|1.6}}</div><br />
<source lang="php">static upload( $src, $dest, [$use_streams] )</source><br />
* '''@return''' {{mark|boolean}} '''True''' bei Erfolg<br />
* '''@since''' {{JVer|1.5}}<br />
<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$src</tt><br />
|<tt>string</tt><br />
|der Name der hochgeladenen (temporären) php Datei<br />
| ---<br />
|-<br />
|<tt>$dest</tt><br />
|<tt>string</tt><br />
|Der Pfad (inklusive Dateinamen) in den Die hochgeladene Datei verschoben werden soll<br />
| ---<br />
|-<br />
|{{JVer|1.6}}<br /><tt>[$use_streams]</tt><br />
|<tt>bool</tt><br />
|Sollen Streams genutzt werden<br />
|<tt>false</tt><br />
|}<br />
<br />
==Beispiel==<br />
<br />
===Eine Datei hochladen===<br />
<br />
====Das HTML Formular zum hochladen====<br />
<br />
<source lang="html4strict"><br />
<form enctype="multipart/form-data" action="index.php" method="post" name="adminForm"><br />
....<br />
<input type="file" name="meine_datei" size="57" /><br />
....<br />
</form><br />
</source><br />
<br />
====Die PHP Datei zur Auswertung====<br />
<source lang="php"><br />
//-- Informationen der hochgeladenen Datei<br />
$datei = JRequest::getVar('meine_datei', null, 'files', 'array' );<br />
<br />
//-- Es wurden keine Dateien gefunden<br />
if( ! is_array($datei) )<br />
{<br />
JError::raiseWarning(100, 'Es wurden keine Dateien gefunden');<br />
<br />
return false;<br />
}<br />
<br />
//-- Fehler beim hochladen der Datei<br />
if( $datei['error'] || $datei['size'] < 1 )<br />
{<br />
JError::raiseWarning(100, 'Fehler beim hochladen der Datei');<br />
<br />
return false;<br />
}<br />
<br />
//-- Erstellen der Pfade<br />
$config = JFactory::getConfig();<br />
$tmp_dest = $config->getValue('config.tmp_path').DS.$datei['name'];<br />
$tmp_src = $datei['tmp_name'];<br />
<br />
//-- Die hochgeladene Datei verschieben<br />
if( ! JFile::upload($tmp_src, $tmp_dest) )<br />
{<br />
echo 'Die Datei konnte nicht hochgeladen werden';<br />
<br />
return false;<br />
}</source><br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#upload JFile->upload()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/upload</jcodedisplay><br />
<br />
[[Kategorie:Experten|upload]]<br />
[[Kategorie:Joomla! Programmierung|upload]]<br />
[[Kategorie:Framework|upload]]<br />
[[Kategorie:JFile|upload]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/writeJFile/write2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/write“ nach „JFile/write“: Struktur angepasst</p>
<hr />
<div>'''JFile::write''' schreibt in eine Datei.<br />
<br />
==Syntax==<br />
<div style="float: left; padding: 0.3em;">{{JVer|1.5}}</div><br />
<source lang="php">static write( $file, $buffer )</source><br />
<div style="float: left; padding: 0.3em;">{{JVer|1.6}}</div><br />
<source lang="php">static write( $file, $buffer, [$use_streams] )</source><br />
* '''@return''' {{mark|boolean}} '''True''' bei Erfolg<br />
* '''@since''' {{JVer|1.5}}<br />
<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$file</tt><br />
|<tt>string</tt><br />
|Der komplette Pfad zur Datei<br />
| ---<br />
|-<br />
|<tt>$buffer</tt><br />
|<tt>string</tt><br />
|Der zu schreibende Text<br />
| ---<br />
|-<br />
|{{JVer|1.6}}<br /><tt>[$use_streams]</tt><br />
|<tt>bool</tt><br />
|Sollen Streams genutzt werden<br />
|<tt>false</tt><br />
|}<br />
<br />
==Beispiel==<br />
<source lang="php"><br />
$fileName = 'pfad'.DS.'zur'.DS.'datei.txt';<br />
$buffer = 'nafu';<br />
<br />
if( JFile::write($fileName, $buffer) )<br />
{<br />
echo 'Die Datei wurde geschrieben';<br />
}<br />
</source><br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#write JFile->write()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/write</jcodedisplay><br />
<br />
[[Kategorie:Experten|write]]<br />
[[Kategorie:Joomla! Programmierung|write]]<br />
[[Kategorie:Framework|write]]<br />
[[Kategorie:JFile|write]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/readJFile/read2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/read“ nach „JFile/read“: Struktur angepasst</p>
<hr />
<div>'''JFile/read''' liest den Inhalt einer Datei.<br />
<br />
==Syntax==<br />
<source lang="php">static read( $filename, [$incpath], [$amount], [$chunksize], [$offset] )</source><br />
* '''@return''' {{mark|mixed}} - {{mark|string}} Der Inhalt der Datei / {{mark|bool}} '''false''' bei einem Fehler<br />
* '''@since''' {{JVer|1.5}}<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$filename</tt><br />
|<tt>string</tt><br />
|Der komplette Pfad zur Datei<br />
| ---<br />
|-<br />
|<tt>[$incpath]</tt><br />
|<tt>boolean</tt><br />
|Soll der Include Path genutzt werden ?<br />
|<tt>false</tt><br />
|-<br />
|<tt>[$amount]</tt><br />
|<tt>integer</tt><br />
|Die Menge die von der Datei gelesen werden soll<br />
|<tt>0</tt><br />
|-<br />
|<tt>[$chunksize]</tt><br />
|<tt>integer</tt><br />
|Die Grösse der Stücke (chunks)<br />
|<tt>8192</tt><br />
|-<br />
|<tt>[$offset]</tt><br />
|<tt>integer</tt><br />
|Der Versatz (offset)<br />
|<tt>0</tt><br />
|}<br />
<br />
==Beispiel==<br />
<source lang="php"><br />
$fileName = 'pfad'.DS.'zur'.DS.'datei.txt';<br />
<br />
if( ! $buffer = JFile::read($fileName) )<br />
{<br />
echo 'Die Datei konnte nicht gelesen werden';<br />
return false;<br />
}<br />
<br />
echo $buffer;</source><br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#read JFile->read()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/read</jcodedisplay><br />
<br />
[[Kategorie:Experten|read]]<br />
[[Kategorie:Joomla! Programmierung|read]]<br />
[[Kategorie:Framework|read]]<br />
[[Kategorie:JFile|read]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/moveJFile/move2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/move“ nach „JFile/move“: Struktur angepasst</p>
<hr />
<div>'''JFile::move''' verschiebt eine Datei.<br />
<br />
==Syntax==<br />
<div style="float: left; padding: 0.3em;">{{JVer|1.5}}</div><br />
<source lang="php">static move( $src, $dest, [$path] )</source><br />
<div style="float: left; padding: 0.3em;">{{JVer|1.6}}</div><br />
<source lang="php">static move( $src, $dest, [$path], [$use_streams] )</source><br />
* '''@return''' {{mark|boolean}} '''True''' bei Erfolg<br />
* '''@since''' {{JVer|1.5}}<br />
<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$src</tt><br />
|<tt>string</tt><br />
|Der Pfad zur Quelldatei<br />
| ---<br />
|-<br />
|<tt>$dest</tt><br />
|<tt>string</tt><br />
|Der Pfad zur Zieldatei<br />
| ---<br />
|-<br />
|<tt>[$path]</tt><br />
|<tt>string</tt><br />
|Ein Pfad der beiden Pfaden vorangestellt wird <br />
|<tt>' '</tt><br />
|-<br />
|{{JVer|1.6}}<br /><tt>[$use_streams]</tt><br />
|<tt>bool</tt><br />
|Sollen Streams genutzt werden<br />
|<tt>false</tt><br />
|}<br />
<br />
==Beispiel==<br />
<source lang="php"><br />
if( ! JFile::move('pfad'.DS.'zur'.DS.'quelle.php', 'pfad'.DS.'zum'.DS.'ziel.php', JPATH_ROOT) )<br />
{<br />
echo 'Die Datei konnte nicht verschoben werden';<br />
<br />
return false;<br />
}</source><br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#move JFile->move()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/move</jcodedisplay><br />
<br />
[[Kategorie:Experten|move]]<br />
[[Kategorie:Joomla! Programmierung|move]]<br />
[[Kategorie:Framework|move]]<br />
[[Kategorie:JFile|move]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/deleteJFile/delete2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/delete“ nach „JFile/delete“: Struktur angepasst</p>
<hr />
<div>'''JFile::delete''' löscht eine oder mehrere Dateien.<br />
<br />
==Syntax==<br />
<source lang="php">static delete( $file )</source><br />
* '''@return''' {{mark|boolean}} ''True'' bei Erfolg<br />
* '''@since''' {{JVer|1.5}}<br />
<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$file</tt><br />
|<tt>mixed</tt><br />
|Der Name der Datei oder ein Array mit Dateinamen<br />
|<br />
|}<br />
<br />
==Beispiel==<br />
<source lang="php"><br />
//--Löschen einer einzelnen Datei<br />
if( JFile::delete('pfad'.DS.'zur'.DS.'datei.php') )<br />
{<br />
echo 'Die Datei wurde gelöscht.';<br />
}<br />
<br />
//--Löschen aller Dateien in einem Ordner<br />
$ordner = JPATH_COMPONET.DS.'verzeichnis';<br />
$dateien = JFolder::files($ordner);<br />
if( JFile::delete($dateien) )<br />
{<br />
prinf 'Alle Dateien im Verzeichnis %s gelöscht', $ordner);<br />
}</source><br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#delete JFile->delete()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/delete</jcodedisplay><br />
<br />
[[Kategorie:Experten|delete]]<br />
[[Kategorie:Joomla! Programmierung|delete]]<br />
[[Kategorie:Framework|delete]]<br />
[[Kategorie:JFile|delete]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/copyJFile/copy2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/copy“ nach „JFile/copy“: Struktur angepasst</p>
<hr />
<div>'''JFile/copy''' Kopiert eine Datei.<br />
<br />
Ist der [[FTP Layer]]{{@todo|link}} aktiv, so wird dieser genutzt.<br />
<br />
==Syntax==<br />
<div style="float: left; padding: 0.3em;">{{JVer|1.5}}</div><br />
{{syntax|<source lang="php" enclose="none">static copy( $src, $dest, [$path] )</source>}}<br />
<div style="float: left; padding: 0.3em;">{{JVer|1.6}}</div><br />
{{syntax|<source lang="php" enclose="none">static copy( $src, $dest, [$path], [$use_streams] )</source>}}<br />
* '''@return''' {{mark|boolean}} '''True''' bei Erfolg<br />
* '''@since''' {{JVer|1.5}}<br />
<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$src</tt><br />
|<tt>string</tt><br />
|Der Pfad zur Quelldatei<br />
| ---<br />
|-<br />
|<tt>$dest</tt><br />
|<tt>string</tt><br />
|Der Pfad zur Zieldatei<br />
| ---<br />
|-<br />
|<tt>[$path]</tt><br />
|<tt>string</tt><br />
|Ein Pfad der beiden Pfaden vorangestellt wird<br />
|<tt>null</tt><br />
|-<br />
|{{JVer|1.6}}<br /><tt>[$use_streams]</tt><br />
|<tt>boolean</tt><br />
|Sollen Streams{{@todo |link}} genutzt werden<br />
|<tt>false</tt><br />
|}<br />
<br />
==Beispiel==<br />
<br />
===Eine Datei kopieren===<br />
<source lang="php"><br />
if( JFile::copy('pfad'.DS.'zur'.DS.'quelle.php', 'pfad'.DS.'zum'.DS.'ziel.php', JPATH_ROOT) )<br />
{<br />
echo 'Die Datei wurde kopiert';<br />
}<br />
</source><br />
<br />
Bei einem Fehler während der Ausführung der Funktion wird eine [[Joomla!_Programmierung/Framework/JError/raiseWarning|JError::raiseWarning]] Fehlermeldung ausgegeben<br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#copy JFile->copy()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/copy</jcodedisplay><br />
<br />
[[Kategorie:Experten|copy]]<br />
[[Kategorie:Joomla! Programmierung|copy]]<br />
[[Kategorie:Framework|copy]]<br />
[[Kategorie:JFile|copy]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/makeSafeJFile/makeSafe2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/makeSafe“ nach „JFile/makeSafe“: Struktur angepasst</p>
<hr />
<div>'''JFile/makeSafe''' gibt einen "sicheren" Dateinamen zurück.<br />
<br />
==Syntax==<br />
<source lang="php">static makeSafe( $file )</source><br />
* '''@return''' {{mark|string}} Der bereinigte Dateiname<br />
* '''@since''' {{JVer|1.5}}<br />
<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$file</tt><br />
|<tt>string</tt><br />
| Der Dateiname ohne Pfadangabe<br />
| ---<br />
|}<br />
<br />
==Beispiel==<br />
<source lang="php"><br />
$input = '../../../folder/../../file.php';<br />
<br />
echo JFile::makeSafe($input);<br />
</source><br />
Ausgabe<br />
folderfile.php<br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#makeSafe JFile->makeSafe()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/makeSafe</jcodedisplay><br />
<br />
[[Kategorie:Experten|makeSafe]]<br />
[[Kategorie:Joomla! Programmierung|makeSafe]]<br />
[[Kategorie:Framework|makeSafe]]<br />
[[Kategorie:JFile|makeSafe]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/stripExtJFile/stripExt2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/stripExt“ nach „JFile/stripExt“: Struktur angepasst</p>
<hr />
<div>__NOTOC__'''JFile/stripExt''' entfernt die Dateiendung einer Datei.<br />
<br />
==Syntax==<br />
<source lang="php">static stripExt( $file )</source><br />
* '''@return''' {{mark|string}} Der Name der Datei ohne Dateiendung<br />
* '''@since''' {{JVer|1.5}}<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$file</tt><br />
|<tt>string</tt><br />
|Der Name der Datei<br />
|<br />
|}<br />
<br />
==Beispiele==<br />
Dateiendung entfernen<br />
<source lang="php">echo JFile::stripExt('configuration.php');</source><br />
Ausgabe<br />
configuration<br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#stripExt JFile->stripExt()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/stripExt</jcodedisplay><br />
<br />
[[Kategorie:Experten|stripExt]]<br />
[[Kategorie:Joomla! Programmierung|stripExt]]<br />
[[Kategorie:Framework|stripExt]]<br />
[[Kategorie:JFile|stripExt]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFile/getExtJFile/getExt2012-05-18T23:56:31Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile/getExt“ nach „JFile/getExt“: Struktur angepasst</p>
<hr />
<div>'''JFile/getExt''' gibt die Dateiendung der Datei zurück.<br />
<br />
==Syntax==<br />
<source lang="php">static getExt( $file )</source><br />
* '''@return''' {{mark|string}} Die Dateiendung<br />
* '''@since''' {{JVer|1.5}}<br />
{| class="wikitable"<br />
!Parameter<br />
!Datentyp<br />
!Beschreibung<br />
!Standardwert<br />
|-<br />
|<tt>$file</tt><br />
|<tt>string</tt><br />
|Der Dateiname oder ein kompletter Pfad<br />
|<br />
|}<br />
<br />
==Beispiel==<br />
<source lang="php"><br />
echo JFile::getExt('configuration.php');<br />
</source><br />
Ausgabe:<br />
php<br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html#getExt JFile->getExt()]</tt> auf api.joomla.org<br />
<br />
==Quellcode==<br />
<jcodedisplay>JFile/getExt</jcodedisplay><br />
<br />
[[Kategorie:Experten|getExt]]<br />
[[Kategorie:Joomla! Programmierung|getExt]]<br />
[[Kategorie:Framework|getExt]]<br />
[[Kategorie:JFile|getExt]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JFileJoomla! Programmierung/Framework/JFile2012-05-18T23:56:30Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile“ nach „JFile“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JFile]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JFileJFile2012-05-18T23:56:30Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JFile“ nach „JFile“: Struktur angepasst</p>
<hr />
<div>'''JFile''' ist eine Klasse zum bearbeiten von Dateien.<br />
<br />
==Definiert in==<br />
{{folder|/libraries/joomla}}<br />
*{{folder|filesystem|red}}<br />
**{{file|file.php|php}}<br />
<br />
* '''@static'''<br />
* '''@since''' {{JVer|1.5}}<br />
==Importieren==<br />
<source lang="php">jimport( 'joomla.filesystem.file' );</source><br />
<br />
==Erweitert==<br />
* Keine<br />
<br />
==Wird erweitert von==<br />
* Keine<br />
<br />
==Methoden==<br />
{| class="wikitable"<br />
|-<br />
!Name<br />
!Beschreibung<br />
|-<br />
| [[/getExt|getExt]]<br />
|Gibt die Dateiendung der Datei zurück.<br />
|-<br />
| [[/stripExt|stripExt]]<br />
|Entfernt die Dateiendung einer Datei.<br />
|-<br />
| [[/makeSafe|makeSafe]]<br />
|Gibt einen "sicheren" Dateinamen zurück.<br />
|-<br />
| [[/copy|copy]]<br />
|Kopiert eine Datei.<br />
|-<br />
| [[/delete|delete]]<br />
|Löscht eine oder mehrere Dateien.<br />
|-<br />
| [[/move|move]]<br />
|Verschiebt eine Datei.<br />
|-<br />
| [[/read|read]]<br />
|Liest den Inhalt einer Datei.<br />
|-<br />
| [[/write|write]]<br />
|Schreibt in eine Datei.<br />
|-<br />
| [[/upload|upload]]<br />
|Verschiebt eine hochgeladene Datei in ein Zielverzeichnis.<br />
|-<br />
| [[/exists|exists]]<br />
|Führt die standard PHP Funktion [http://www.php.net/manual/en/function.file-exists.php file_exists] aus.<br />
|-<br />
| [[/getName|getName]]<br />
|Extrahiert aus einem kompletten Pfad den Dateinamen.<br />
|}<br />
<br />
==Siehe auch==<br />
* <tt>[http://api.joomla.org/Joomla-Framework/FileSystem/JFile.html JFile]</tt> auf api.joomla.org<br />
<br />
[[Kategorie:Experten|JFile]]<br />
[[Kategorie:Joomla! Programmierung|JFile]]<br />
[[Kategorie:Framework|JFile]]<br />
[[Kategorie:JFile|JFile]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_SeitenJoomla! Seiten2012-05-09T02:50:50Z<p>Bembelimen: Beschreibungstext geändert</p>
<hr />
<div>__NOTOC__<br />
<br />
{| cellspacing="0" cellpadding="0" style="margin:0em 0em 1em 0em; width:100%"<br />
| style="width:50%; vertical-align:top; border:1px solid #A0522D; background-color: #FFF8DC;" rowspan="1"|<br />
<div style="border-bottom:1px solid #A0522D; background-color:#F5DEB3; padding:0.2em 0.5em 0.2em 0.5em; font-size:110%; font-weight:bold;"><br />
offizielle Seiten</div><br />
<div style="padding:0.4em 1em 0.3em 1em;"><br />
;[http://www.joomla.org www.joomla.org]:offizielle Joomla! Hauptseite<br />
;[http://forum.joomla.org forum.joomla.org]:offizielles Joomla! Forum<br />
;[http://extensions.joomla.org extensions.joomla.org]:offizielles Joomla! Extensionverzeichnis<br />
;[http://docs.joomla.org docs.joomla.org]:offizielle Joomla! Dokumentation<br />
;[http://community.joomla.org community.joomla.org]:offizielle Joomla! Communityseite<br />
;[http://resources.joomla.org resources.joomla.org]:offizielles Joomla! Resourcenverzeichnis<br />
;[http://developer.joomla.org developer.joomla.org]:offizielles Joomla! Entwicklerseite<br />
;[http://shop.joomla.org shop.joomla.org]:offizieller Joomla! Shop<br />
</div><br />
| style="padding:0em 0.5em 0em 0.5em;" |<br />
| style="width:50%; vertical-align:top; border:1px solid gold; background-color: White;" |<br />
<div style="border-bottom:1px solid gold; background-color:#ffffaa; padding:0.2em 0.5em 0.2em 0.5em; font-size:110%; font-weight:bold;">Landesseiten</div><br />
<div style="padding:0.4em 1em 0.3em 1em;"><br />
;[http://www.joomla.de joomla!.de]:deutsche Landesseite<br />
;[http://www.joomla.ch joomla!.ch]:schweizer Landesseite<br />
;[http://www.joomla.at joomla!.at]:österreichische Landesseite<br />
</div><br />
<div style="border-bottom:1px solid gold; border-top:1px solid gold; background-color:#ffffaa; padding:0.2em 0.5em 0.2em 0.5em; font-size:110%; font-weight:bold;">Chat</div><br />
<div style="padding:0.4em 1em 0.3em 1em;"><br />
;[http://www.joomla-supportchat.de/ joomla-supportchat.de]:Supportchat für Joomla!<br />
</div><br />
<div style="border-bottom:1px solid gold; border-top:1px solid gold; background-color:#ffffaa; padding:0.2em 0.5em 0.2em 0.5em; font-size:110%; font-weight:bold;">Foren</div><br />
<div style="padding:0.4em 1em 0.3em 1em;"><br />
;[http://forum.joomla-nafu.de forum.joomla-nafu.de]:Joomla! Forum für ambitionierte Nutzer<br />
;[http://www.joomla-downloads.de/forum/ joomla-downloads.de/forum]:Hilfe und Supportforum<br />
;[http://www.joomlaportal.de joomlaportal.de]:Joomla CMS Support Forum<br />
;[http://forum.joomla.ch forum.joomla.ch]:schweizer Landesforum<br />
</div><br />
|}<br />
<br />
{| cellspacing="0" cellpadding="0" style="margin:0em 0em 1em 0em; width:100%"<br />
| style="width:50%; vertical-align:top; border:1px solid #abd5f5; background-color: #f1f5fc;" rowspan="1"|<br />
<div style="border-bottom:1px solid #abd5f5; background-color:#d0e5f5; padding:0.2em 0.5em 0.2em 0.5em; font-size:110%; font-weight:bold;"><br />
Downloadportale</div><br />
<div style="padding:0.4em 1em 0.3em 1em;"><br />
;[http://www.joomlaos.de joomlaos.de]:Templates und Erweiterungen<br />
;[http://www.joomla-downloads.de joomla-downloads.de]:Joomla! Downloads<br />
</div><br />
| style="padding:0em 0.5em 0em 0.5em;" |<br />
| style="width:50%; vertical-align:top; border:1px solid #A0522D; background-color: #FFF8DC;" rowspan="1"|<br />
<div style="border-bottom:1px solid #A0522D; background-color:#F5DEB3; padding:0.2em 0.5em 0.2em 0.5em; font-size:110%; font-weight:bold;"><br />
Newsseiten</div><br />
<div style="padding:0.4em 1em 0.3em 1em;"><br />
;[http://www.joomlastuff.ch joomlastuff.ch]:Die Neusten Informationen aus der Joomla!-Welt<br />
;[http://www.joomla-aktuell.de joomla-aktuell.de]:Aktuelles rund um Joomla!<br />
</div><br />
|}</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Template_OverrideTemplate Override2012-04-24T14:25:21Z<p>Bembelimen: Weiterleitung hinzugefügt</p>
<hr />
<div>#WEITERLEITUNG [[Diskussion:Templates Overrides]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/OverrideOverride2012-04-24T14:24:51Z<p>Bembelimen: Weiterleitung hinzugefügt</p>
<hr />
<div>#WEITERLEITUNG [[Diskussion:Templates Overrides]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Diskussion:Joomla!_Programmierung/Programmierung/Templates/OverridesDiskussion:Joomla! Programmierung/Programmierung/Templates/Overrides2012-04-24T14:23:34Z<p>Bembelimen: verschob „Diskussion:Joomla! Programmierung/Programmierung/Templates/Overrides“ nach „Diskussion:Templates Overrides“</p>
<hr />
<div>#WEITERLEITUNG [[Diskussion:Templates Overrides]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Programmierung/Templates/OverridesJoomla! Programmierung/Programmierung/Templates/Overrides2012-04-24T14:23:34Z<p>Bembelimen: verschob „Joomla! Programmierung/Programmierung/Templates/Overrides“ nach „Templates Overrides“</p>
<hr />
<div>#WEITERLEITUNG [[Templates Overrides]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Templates_OverridesTemplates Overrides2012-04-24T14:23:34Z<p>Bembelimen: verschob „Joomla! Programmierung/Programmierung/Templates/Overrides“ nach „Templates Overrides“</p>
<hr />
<div>== Vorwort ==<br />
Der vorliegende Text ist eine Interpretation, in erster Linie aber eine Übersetzung des Tutorials von Andrew Eddie: ''„Understanding Output Overrides in Joomla! 1.5“''. Den original Text finden Sie unter der Adresse: http://docs.joomla.org/Understanding_Output_Overrides<br />
<br />
== Einleitung ==<br />
Als Webdesigner werden Sie bei Ihrer täglichen Arbeit mit verschiedenen, zum Teil gegensätzlichen Anforderungen konfrontiert. Diese reichen von gesetzlichen Vorgaben, Barrierefreiheit und Usability bis hin zu persönlichen Vorlieben. Entgegen dem Versuch Ihnen diese Freiheiten bei der Gestaltung der Ansichten Ihrer Webseite über möglichst viele Schalter zu gewährleisten und dadurch Gefahr zu laufen diese zu überladen, oder dem Kompromiss eines nur bedingt zufriedenstellenden Mittelwegs, gibt Joomla! Ihnen die volle Kontrolle über die Gestaltung der Ausgaben.<br />
<br />
Joomla! wurde bislang vorgeworfen teils altertümliche Ziele bei der Einhaltung von Webstandards zu verfolgen, oder sich nicht sonderlich mit Themen wie der [[Wikipedia:de:Barrierefreies_Internet|Gleichstellung]] zu befassen. Seit der Version 1.5 ist diese Verantwortung, oder besser – die Machbarkeit – wieder ganz bei Ihnen.<br />
<br />
Da nun jegliche Anpassungen (sog. Overrides) der Standard-Ausgaben über das [[Joomla!_Programmierung/Programmierung/Templates|Template]] in die Webseite eingebunden werden, erübrigen sich Probleme wie beispielsweise das versehentlichen Überschreiben von veränderten Systemdateien bei einer Aktualisierung durch einen Administrator.<br />
<br />
== MVC Grundlagen ==<br />
Model/View/Controller, oder ins Deutsche übersetzt ''„Modell/Präsentation/Steuerung“'' ist ein Architekturmuster aus der Software-Entwicklung, bestehend aus den Schichten; Datenmodell (engl. model), Präsentation (engl. view) und Programmsteuerung (engl. controller). Ziel des Musters ist ein flexibler Programmentwurf, der eine spätere Änderung oder Erweiterung erleichtert und eine Wiederverwendbarkeit der einzelnen Komponenten ermöglicht.<br />
<br />
Für den Web-Entwickler ist eigentlich nur die Präsentationsschicht (View) von Interesse. Sollten sie dennoch neugierig sein, finden Sie in den weiterführenden Links eine ausführlichere Beschreibung dieses Konzepts.<br />
{{weitere|Joomla! Programmierung/Model View Controller|Model View Controller}}<br />
<br />
Die [[Joomla! erweitern|Verschiedene Erweiterungstypen]] innerhalb von Joomla! generieren ihre Ausgabe auf unterschiedliche Weise.<br />
<br />
Wie Sie sicher bereits wissen sind Komponenten die umfangreichste Form von Erweiterungen. Am Beispiel der Artikelverwaltung (com_content) sehen Sie, auf welch vielfältige Weise Artikel, oder wenn Sie so möchten auch Beiträge, dargestellt werden können. So haben Sie die Wahl Artikel innerhalb eines Bereichs, einer Kategorie oder den Beitrag direkt anzeigen zu lassen. Diese Unterteilung der Darstellung wird ''„View“'' genannt und ist die Umsetzung der [[Joomla! Programmierung/Model View Controller#Pr.C3.A4sentation_.28view.29|Präsentationsschicht]] aus dem MVC Konzept.<br />
<br />
Komponenten haben häufig mehr als eine solche ''„View“''. Dennoch sind es nicht die ''„Views“'' die für die eigentlichen Ausgaben verantwortlich sind. Es gibt folglich eine weitere Unterteilung in sogenannte ''„Layouts“'', wobei eine ''„View“'' wiederum mehrere ''„Layouts“'' besitzen kann.<br />
<br />
Jede View bereitet nun die über das Model erhaltenen Informationen auf und stellt sie dem Layout oder den Layouts zur Verfügung. Nehmen wir erneut das Beispiel der Artikelverwaltung …<br />
<br />
Für die Anzeige von Beiträgen innerhalb einer Kategorie gibt es zwei Darstellungsmöglichkeiten. Zum einen wäre da das ''„Kategorie-Blog“'' Layout und als Alternative die ''„Kategorie-Liste“''. In beiden Fällen werden die gleichen Informationen verarbeitet, jedoch auf unterschiedliche Weise ausgegeben.<br />
<br />
Die Ausgabe von Modulen hingehen ist recht überschaubar. Generell besitzen Module keine Views, jedoch erlauben sie die Verwendung von Layouts, welche beispielsweise als Option innerhalb der Moduleinstellungen geändert werden können.<br />
<br />
== Unterscheidung zwischen Template und Layout ==<br />
Während Templates einen strukturellen Rahmen für die Seiten Ihrer Internetpräsenz festlegen, sind es die Views oder Layouts einer Komponente oder eines Moduls, welche für die eigentliche Ausgabe von Inhalten zuständig sind.<br />
<br />
Das folgende Bild zeig die Struktur und den Aufbau eines typischen Joomla! Templates (rhuk_milkyway). Um die Modulpositionen eines Templates sichtbar zu machen fügen Sie ans Ende der Adresse Ihrer Seite die Zeichenfolge ''„index.php?tp=1“'' ein.<br />
<br />
BILD<br />
<br />
Wie bereits erwähnt werden die Inhalte der Positionen im Template durch die Layouts der Erweiterungen bestimmt.<br />
<br />
=== Zusatzinformationen ===<br />
Wenn auch nicht zwingend dem MVC Konzept zugehörig, gibt es zwei weitere Methoden zur Beeinflussung der Darstellung.<br />
<br />
Hier im Wiki befindet sich unter dem Punkt [[Joomla! Programmierung/Programmierung/Templates|Joomla! Programmierung Templates]] eine detaillierte Beschreibung zu den kurz vorzustellenden [[Joomla! Programmierung/Programmierung/Templates#modules.php|''„Modul Chromes“'']]. Darunter auch eine Anleitung zum Erstellen eigener ''„Chromes“''. Das jeweilige Chrome, oder auch - der Rahmen in dem ein Modul eingebunden ist, wird beim einfügen einer Modulposition in der {{file|index.php|php}} des Templates über das „style“ Attribut im jdoc include Tag festgelegt. Sollte Ihnen das gerade zu schnell gegangen sein folgt zur Veranschaulichung ein Beispiel, dass Sie sicher bereits schon einmal gesehen haben werden.<br />
<jdoc:include type="modules" name="left" style="xhtml" /><br />
<br />
Welche Ausgabe durch die sechs von Joomla! bereits unterstützten ''„Chromes Styles“'' erzeugt wird, zeigt die folgende Grafik.<br />
<br />
GRAFIK<br />
<br />
Ein- oder ausfahrbare Menüs oder Anmeldeformulare wären ein Beispiel für eigens erstellte Chromes wie sie auch im ja_purity Template zu finden sind.<br />
<br />
Ein weiterer Ansatz sind die Kontrollelemente welche für die Steuerung von mehrseitigen Ansichten benutzt werden (Pagination). Dazu später mehr.<br />
<br />
== Ausgabetypen der Komponenten und überschreiben von Layout Dateien ==<br />
Zum besseren Verständnis der Overrides ist es notwendig sich die Dateistruktur von Komponenten anzusehen. Andere Bereiche außer acht gelassen, widmen wir uns dem Verzeichnis {{folder|views}}. Dazu ein Auszug der Verzeichnisstruktur der Artikelverwaltung (com_content).<br />
<br />
{{folder|components}}<br /><br />
:<sup>|_</sup> {{folder|com_content}}<br /><br />
::<sup>|_</sup> {{folder|views}}<br /><br />
:::<sup>|_</sup> {{folder|article}}<br /><br />
::::<sup>|_</sup> {{folder|tmpl}}<br /><br />
:::::<sup>|_</sup> {{file|default.php|php}} (Standard Layout)<br /><br />
:::::<sup>|_</sup> {{file|form.php|php}} (Formular Layout)<br /><br />
::::<sup>|_</sup> {{file|view.html.php|php}} (View für die Darstellung von Html Inhalten)<br /><br />
::::<sup>|_</sup> {{file|view.pdf.php|php}} (View für die Darstellung von PDF Inhalten)<br /><br />
:::<sup>|_</sup> {{folder|category}}<br /><br />
::::<sup>|_</sup> {{folder|tmpl}}<br /><br />
:::::<sup>|_</sup> {{file|default.php|php}} (Standard Layout)<br /><br />
:::::<sup>|_</sup> {{file|default_items.php|php}} (Standard Layout Unteransicht)<br /><br />
:::::<sup>|_</sup> {{file|blog.php|php}} (Blog Layout)<br /><br />
:::::<sup>|_</sup> {{file|blog_items.php|php}} (Blog Layout Unteransicht)<br /><br />
:::::<sup>|_</sup> {{file|blog_links.php|php}} (Blog Layout Unteransicht)<br /><br />
::::<sup>|_</sup> {{file|view.html.php|php}} (View für die Darstellung von Html Inhalten)<br /><br />
::::<sup>|_</sup> {{file|view.feed.php|php}} View für die Darstellung von RSS Feeds)<br /><br />
<br />
Wie hier zu sehen befinden sich die Views in einem separaten Verzeichnis. Die Artikelverwaltung besitzt drei weitere Views: archive, frontpage und section.<br />
<br />
=== AusgabeTypen ===<br />
Wenn wir von einer View sprechen, dann ist mit großer Wahrscheinlichkeit die Datei view.html.php gemeint. Der Dateiname folgt einer Konvention und variiert je nach Ausgabe-Typ. Mögliche Ausgabe-Typen sind: view.html.php, view.feed.php, view.pdf.php, view.raw.php oder view.error.php. Das bedeutet, wann immer eine der genannten Ausgabeformen angefragt wird, erwartet das System die entsprechende Datei.<br />
Weitere Informationen hierzu finden Sie in der Api Dokumentation unter JDocument. Werfen Sie auch einen Blick in das Verzeichnis /libraries/joomla/document.<br />
<br />
Am ehesten ist dieser Vorgang nachvollziehbar, wenn Sie in der Konfiguration Ihres Systems suchmaschinenfreundliche URLs aktivieren. Dabei sollte die Optionen „mod_rewrite nutzen“ sowie<br />
„Dateiendung an URL fügen“ angewählt sein. Das Resultat könnte zum Beispiel so aussehen:<br />
<br />
http://domain/sport.html<br />
http://domain/sport.feed<br />
http://domain/sport/rudern.html<br />
http://domain/sport/rudern.pdf<br />
<br />
Hinweis: Unter Umständen funktioniert die Aktivierung suchmaschinenfreundlicher URLs nicht in einer lokalen Testumgebung.<br />
<br />
Die Ausgabe der Adresse variiert selbstverständlich je nachdem wie Sie Ihr System konfiguriert haben. Der eigentliche Punkt jedoch ist, dass „sport.html“ intern die view.html.php der Kategorie verwendet, während „sport.feed“ für die Bereitstellung eines RSS Feeds auf die Datei view.feed.php zurückgreift. Als Anmerkung hierzu: Zum jetzigen Zeitpunkt ist es nicht möglich die Ausgabe von Feeds oder PDF anzupassen. Dies gilt jedoch nicht für die Ausgabe von Html und an dieser Stelle kommen die „Layouts“ ins Spiel.<br />
<br />
Layouts<br />
Die Layouts befinden sich, vorausgesetzt die Erweiterung hält sich an das MVC Prinzip, in dem Verzeichnis /tmpl unterhalb einer View. Jede der PHP Dateien repräsentiert ein solches Layout.<br />
<br />
Beispiele:<br />
Die Datei article/tmpl/default.php entspricht dem standard Layout eines Artikels. Bearbeitet man einen Artikel wird im Controller der Artikelverwaltung der View mitgeteilt die Datei article/tmpl/form.php zu laden. Ähnlich verhält es sich mit der Kategorie Ansicht, in der die gleichen Informationen zu den Artikeln entweder als Liste category/tmpl/default.php, oder als Blog category/tmpl/blog.php ausgegeben werden. <br />
<br />
Verständlicher wird das Zusammenspiel zwischen Views und deren Layouts wenn wir uns der Erstellung eines neuen Menüpunktes widmen. Der untere Bildausschnitt zeigt eine Baumstruktur der Views und dessen Layouts aus der Artikelverwaltung.<br />
<br />
BILD<br />
<br />
Vielleicht ist Ihnen aufgefallen, dass einige Layouts wie pagebreak.php nicht aufgeführt wurden und sich weiterhin eine gleichnamige XML Datei im /tmpl Verzeichnis befindet. Im Kapitel Komponenten Parameter gehen wir näher auf die Optionen dieser XML Dateien ein und erklären unter anderem wie Layouts oder auch ganze Views versteckt werden können.<br />
<br />
Mit den erworbenen Kenntnissen über die Zusammenhänge der Dateien sind wir nun in der Lage zum Erstellen eigener Overrides überzugehen. <br />
<br />
Kopieren oder Erstellen von Layouts Overrides<br />
Joomla! sucht und benutzt Layout Overrides im /html Verzeichnis des jeweils aktiven Template. Das bedeutet, dass auch wenn Sie für eine bestimmte Erweiterung ein Override erstellt haben, dies nicht automatisch für alle installierten Templates gillt. Werfen wir nun einen Blick in die standard Templates von Joomla!.<br />
<br />
Im Verzeichnis /templates/rhuk_milkyway/html befinden sich zwar die Dateien modules.php und pagination.php, jedoch gibt es im Template rhuk_milkyway sonst keine Overrides für Komponenten oder Module. Im Beez Template hingegen werden weitestgehend alle Ausgaben der Basis-Erweiterungen über Overrides gesteuert. Das JA Purity Template stellt auch einige Overrides bereit, allerdings beschränken diese sich auf nur wenige Layouts.<br />
<br />
Die notwendige Struktur für Layout Overrides sehen wir am Beispiel des Templates Beez:<br />
/templates<br />
/beez<br />
/html<br />
/com_content (Name der Komponente)<br />
/articles (Name der View)<br />
default.php (Name des jeweiligen Layouts)<br />
form.php<br />
<br />
/html/com_name_der_komponente/name_der_view/name_des_layouts.php<br />
<br />
Die Dateistruktur eines Overrides entspricht annähernd der einer Komponente. Da wir nur Layouts überschreiben können, entfällt lediglich das Verzeichnis /tmpl.<br />
Wie oben kurz angedeutet besitzt das rhuk_milkyway Template selbst keine Overrides für die Ausgabe von Komponenten. Um eine Alternative zur standard Darstellung eines Artikels zu erzeugen, kopieren Sie die Datei /components/com_content/views/article/tmpl/default.php in das Verzeichnis /templates/rhuk_milkyway/html/com_content/article/default.php. Sofern die Verzeichnisstruktur nicht vorhanden ist, muss diese natürlich erstellt werden.<br />
<br />
Die gleiche Vorgehensweise ließe sich auf die Blog Ansicht anwenden. Dazu wird die Datei /components/com_content/views/category/tmpl/blog.php nach /templates/rhuk_milkyway/html/com_content/category/blog.php kopiert. Anschließend können die Dateien den eigenen Bedürfnissen, oder auf die eines Kunden angepasst werden.<br />
Achten Sie dennoch darauf vorhandene Parameter Abfragen zu berücksichtigen. Entgegen dem Hinweis aus dem original Text, selbst entscheiden zu können ob und welche Parameter für Sie von Bedeutung sind, kann das Entfernen oder anderweitige Verwenden von diesen Schaltern später für Verwirrung sorgen. Das trifft dann zu, wenn ein Benutzer im Backend versucht eine Option zu aktivieren, sich aber keine Auswirkungen darauf auf der Frontpage zeigen.<br />
<br />
Unter-Layouts überschreiben<br />
Neben den eigentlichen Layouts findet man in der Frontpage oder Kategorie View der Artikelverwaltung eine Gruppe von Dateien mit gleichlautender Anfangsbezeichnung. <br />
<br />
Das Blog-Layout besitzt drei solcher Dateien. Schaut man nun in die blog.php wird deutlich wie die Unter-Layouts mit Hilfe der loadTemplate() Methode geladen werden.<br />
<br />
echo $this->loadTemplate('item') // blog_item.php<br />
echo $this->loadTemplate('links') // blog_links.php<br />
<br />
Der Name des Basis-Layouts in dem wir uns befinden, dient als Präfix und ist innerhalb der View bekannt. Es reicht also aus das Unter-Layout direkt und ohne Angabe dieses Präfixes zu laden.<br />
<br />
Bereits am Beispiel des Templates JA Purity konnten wir sehen, dass man keineswegs gezwungen ist alle Layouts einer View zu überschreiben. Sofern kein Override existiert wird Joomla! weiterhin die nativen Layouts der View einer Erweiterung laden.<br />
<br />
== Modul Layout Overrides ==<br />
Module folgen wie alle Erweiterungen innerhalb Joomla! einer bestimmten Verzeichnis- und Dateistruktur.<br />
/modules<br />
/mod_latest_news<br />
/tmpl<br />
default.php (Layout)<br />
helper.php (Helper Klasse des Moduls)<br />
mod_latest_news.php (Modul Einstiegspunkt)<br />
mod_latest_news.xml (XML Manifest)<br />
<br />
Für Module existiert unterhalb des Hauptverzeichnisses wie schon bei den Views einer Komponente ein /tmpl Verzeichnis. In Abhängigkeit der Funktionalität des Moduls finden sich dort eine oder mehrere Layout Dateien.<br />
Hinweis: Nicht wenige Module die für Joomla! verfügbar sind halten sich nicht an diese Vorgaben. Prüfen Sie deshalb vorher wie das Modul die Ausgabe generiert. <br />
Wie ein Layout Override eines Moduls innerhalb des Templates aussieht zeigt die folgende Darstellung.<br />
<br />
/templates<br />
/beez<br />
/html<br />
/mod_latest_news (Name des Moduls Stammverzeichnisses)<br />
default.php (Layout)<br />
<br />
/html/mod_name_des_moduls/name_des_layouts.php. <br />
<br />
== Kontrollelemente für mehrseitige Ansichten ==<br />
Zu guter Letzt schauen wir uns, wie Anfangs erwähnt, die Anpassung der Ausgaben für Kontrollelement von mehrseitigen Ansichten (Pagination) an.<br />
<br />
BILD<br />
<br />
Im Verzeichnis /html des Templates BEEZ befindet sich eine bereits angepasste und gut dokumentierte Datei mit der Bezeichnung pagination.php. Innerhalb dieser Datei stehen vier Funktionen für verschiedene Ausgaben der Kontrollelemente zur Verfügung. <br />
<br />
pagination_list_footer()<br />
Diese Funktion generiert eine Auswahlliste mit der die Anzahl der anzuzeigenden Artikel oder Inhalte pro Seite gesetzt werden kann..<br />
<br />
pagination_list_render()<br />
Innerhalb von pagination_list_render() werden die Seitenzahlen, sowie die Start, Ende und Vor/Zurück Links generiert.<br />
<br />
pagination_item_active()<br />
Diese Funktion wirkt sich auf alle aktiven Links innerhalb der Kontrollelemente aus.<br />
<br />
pagination_item_inactive()<br />
Wie der Name vermuten lässt kann hier die Ausgabe inaktiver Elemente beeinflusst werden.<br />
<br />
Spickzettel<br />
Beispiele zu allen in diesem Artikel behandelten Themen zur Anpassung der Ausgaben finden sich in den Core- Erweiterungen und Templates die Joomla! nach der einer Standardinstallation mitbringt.<br />
<br />
Themen Auswahl<br />
<br />
Ausgabetypen der Komponenten und überschreiben von Layout Dateien<br />
Um eine alternative Ausgabe für die Artikelansicht zu erstellen kopieren Sie die Datei:<br />
/components/com_content/views/article/tmpl/default.php<br />
nach:<br />
/templates/NameDesTemplate/html/com_content/article/default.php<br />
<br />
Weitere Informationen LINK<br />
<br />
Modul Layout Overrides<br />
Kopieren Sie das Modul Layout von:<br />
/components/NameDesModuls/tmpl/default.php<br />
nach:<br />
/templates/NameDesTemplate/html/NameDesModuls/default.php<br />
Weitere Informationen LINK<br />
<br />
Modul Chrome<br />
Die Erstellung oder Anpassung von Modul Styles wird im Bereich Joomla! Programmierung | Programmierung | Templates ausführlich behandelt.<br />
<br />
Weitere Informationen LINK<br />
<br />
Kontrollelemente für mehrseitige Ansichten<br />
Eine Beispieldatei für die Anpassung der Pagination findet sich unter:<br />
/templates/beez/html/pagination.php<br />
<br />
== Fazit ==<br />
Auch wenn dieser Artikel nicht die einzige Übersetzung des Textes von Andrew Eddie zum Thema Template Overrides in Joomla! 1.5 ist und der Erscheinungstermin für die Version 1.6 mit weiteren Neuerungen näher zu rücken scheint, so hoffen wir doch Ihnen auf verständliche Weise die Prinzipien und Vorteile der MVC Strukur, sowie die Möglichkeit der Template Overrides näher gebracht zu haben.</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Diskussion:Templates_OverridesDiskussion:Templates Overrides2012-04-24T14:23:34Z<p>Bembelimen: verschob „Diskussion:Joomla! Programmierung/Programmierung/Templates/Overrides“ nach „Diskussion:Templates Overrides“</p>
<hr />
<div>Manchmal möchte man schon ... <br />
<br />
... aber dazu ist dann die Veränderung einer Core-Datei nötig. Beim nächsten Update wird die Änderung dann jedoch überschrieben. <br />
<br />
Ein Beispiel: Mit Menütyp "Layout: Kontaktkategorien" kann das Kontaktbild des jeweiligen Kontaktes nicht dargestellt werden.<br />
<br />
== Eine Lösung heißt Layout-Override. ==<br />
<br />
'''Ein Override ist nur für in einem Verzeichnis {{folder|view}} oder dessen Unterverzeichnis enthaltene Dateien möglich.''' <br />
<br />
Joomla! gibt die Kontaktkategorie-Daten durch die Datei {{file|DeinJoomla!\components\com_contact\views\category\tmpl\default_items.php|php}} aus. Diese Ausgabe kann also durch ein Layout-Override verändert werden. <br />
<br />
Im Template beez wird z. B. mit Overrides gearbeitet. Dort können die folgenden Schritte gut nach vollzogen werden.<br />
<br />
Layout-Overrides benötigen das Verzeichnis {{folder|html}} in Ihrem Template. <br />
<br />
Da die "Original"-Datei in einem Unterverzeichnis von {{folder|DeinJoomla!\components\com_contact}} liegt und eine Datei aus einem Unterverzeichnis von {{file|DeinJoomla!\components\com_contact\views\category}} geändert werden soll, ist es dem entsprechend notwendig ein Verzeichnis {{folder|DeinJoomla!\templates\DeinTemplate\html\com_contact\category}} zu erstellen.<br />
<br />
Dorthin kommt dann eine Datei mit gleichem Namen wie die "Original"-Datei: {{file|default_items.php}}<br />
<br />
Sie bekommt den Inhalt:<br />
<br />
<source lang="php"><br />
<?php <br />
// @version $Id: default_items.php 10381 2008-06-01 03:35:53Z pasamio $<br />
// geändert Inhalt des ersten Tabellenfeldes (Zeile 10): 2010-03-24 7list<br />
defined('_JEXEC') or die('Restricted access');<br />
?><br />
<br />
<?php foreach ($this->items as $item) : ?><br />
<tr><br />
<td class="sectiontableentry" headers="Count"><br />
<img src="<?php echo $this->baseurl ?>/images/stories/<?php echo $item->image?>" width="92" height="117" alt="" border="0"><br />
</td><br />
<br />
<br />
<td valign="top" class="sectiontableentry<?php echo $item->odd; ?>" headers="Position"><br />
<?php if ($this->params->get('show_position')) : ?><br />
<br />
<?php if (strlen($item->con_position)>0){echo $item->con_position."<br>";} ?><br />
<?php endif; ?><br />
<br />
<br />
<a href="<?php echo $item->link; ?>" class="category<?php echo $this->params->get('pageclass_sfx'); ?>"><br />
<?php echo $item->name; ?> </a><br />
</td><br />
<br />
<td width="20px"></td> <br />
<br />
<td valign="top" class="sectiontableentry<?php echo $item->odd; ?>" headers="Mail"><br />
<?php if ($this->params->get('show_email')) : ?> <br />
<?php echo $item->email_to; ?><br />
<br><br />
<?php endif; ?><br />
<br />
<?php if ($this->params->get('show_telephone')) : ?><br />
<br />
<?php echo $item->telephone; ?><br />
<br><br />
<?php endif; ?><br />
<br />
<?php if ($this->params->get('show_mobile')) : ?><br />
<br />
<?php echo $item->mobile; ?><br />
<br><br />
<?php endif; ?><br />
<br />
<?php if ($this->params->get('show_fax')) : ?><br />
<br />
<?php echo $item->fax; ?><br />
<?php endif; ?> <br />
</td><br />
<br />
</tr><br />
<?php endforeach; ?><br />
</source><br />
<br />
== Eine weitere Lösung heißt [[Joomla! erweitern/Komponenten/3rd Party/Jumi|Jumi]]. ==<br />
<br />
Dazu den folgenden Code in die Datei {{file|DeinJoomla!\jumi\contact.categorie.view.feed.php}} eingeben:<br />
<br />
<source lang="php"><br />
<?php<br />
/**<br />
* @version $Id: contact.categorie.view.feed.php 2010-03-24 17:25:58Z kms-net.de<br />
* @package Joomla<br />
* @subpackage Contact<br />
* @copyright Copyright (C) 2005 - 2008 Open Source Matters. All rights reserved.<br />
* @license GNU/GPL, see LICENSE.php<br />
* Joomla! is free software. This version may have been modified pursuant to the<br />
* GNU General Public License, and as distributed it includes or is derivative<br />
* of works licensed under the GNU General Public License or other free or open<br />
* source software licenses. See COPYRIGHT.php for copyright notices and<br />
* details.<br />
*/<br />
// Check to ensure this file is included in Joomla!<br />
defined('_JEXEC') or die( 'Restricted access' );<br />
<br />
<br />
$query = 'SELECT a.name AS name, `con_position` AS position, `address` AS strasse,'<br />
. ' concat( `postcode` , " ", `suburb` ) AS adresse, `telephone` AS telefon,'<br />
. ' `fax`, `email_to` AS email,'<br />
. ' a.image AS image, a.id as id, `catid`,a.alias AS alias ,'<br />
. ' c.title AS category'<br />
. ' FROM joscg_contact_details AS a'<br />
. ' LEFT JOIN joscg_categories AS c ON c.`id`= a.`catid`'<br />
. ' WHERE `catid` = 5'<br />
. ' ORDER BY a.ordering ' ;<br />
<br />
<br />
<br />
$rows = mysql_query($query) OR die("Query: <pre>".$query."</pre><br />
"."Antwort: ".mysql_error());<br />
<br />
$daten = array();<br />
<br />
if(mysql_num_rows($rows)) {<br />
while($row = mysql_fetch_assoc($rows)) { <br />
$daten[] = array($row['name'],$row['position'],$row['strasse'],$row['adresse'],$row['telefon'],$row['fax'],$row['email'],$row['image'],$row['id'],$row['catid'],$row['alias'],$row['category']); <br />
}<br />
} else {<br />
echo "Es sind keine Daten in der Datenbank vorhanden<br />\n";<br />
} <br />
<br />
echo "<table width='100%' border='0'>"; <br />
foreach ($daten as $wert) {<br />
echo "<tr valign='top'>";<br />
echo "<td> <img src='images/stories/".$wert[7]."' width='92' height='117' alt='' border='0'></td>";<br />
echo "<td>";<br />
if (strlen($wert[1])>0){echo $wert[1] ."<br>";} <br />
echo "<a href='index.php?option=com_contact&view=contact&id=".$wert[8].":".$wert[10]."&catid=".$wert[9].":".$wert[11]."&Itemid=15' class='category'>".$wert[0]."</a>";<br />
echo "<br><br><p style='margin-bottom:10px;'>";<br />
if (strlen($wert[4])>0){echo $wert[4] ."<br>" ;}<br />
echo $wert[5]; <br />
echo "</td><td width='15'></td>"; <br />
echo "<td>";<br />
if (strlen($wert[2])>0){echo $wert[2] ."<br>";}<br />
if (strlen($wert[3])>0){echo $wert[3] ;}<br />
echo "</td></tr>";<br />
echo "<tr><td height='10' colspan='5'></td></tr>"; <br />
}<br />
echo "</table>";<br />
?><br />
</source><br />
<br />
Die Datei kann dann mit dem [[Joomla! erweitern/Plugins/3rd Party/Jumi|Jumi-Plugin]] im Beitrag mit {jumi [jumi/categorie.contact.view.feed.php]} eingebunden werden.</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JTableNestedJoomla! Programmierung/Framework/JTableNested2012-04-14T11:29:37Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTableNested“ nach „JTableNested“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JTableNested]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTableNestedJTableNested2012-04-14T11:29:37Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTableNested“ nach „JTableNested“: Struktur angepasst</p>
<hr />
<div>'''JTableNested''' is a table class which supports modified pre-order [[wikipedia:tree traversal|tree traversal]] behaviour. This class is derived from the base [[JTable]] class and adds methods to support a binary tree structure in the database, with pre-order being the preferred method of traversal. From Joomla 1.6 onwards.<br />
<br />
===Defined in===<br />
/joomla/database/tablenested.php<br />
<br />
===Extends===<br />
* [[JTable]]<br />
<br />
===Reserved Database Field Names===<br />
The operation of this class is dependent on the existence of specially-named fields (columns) in the database table.<br />
{| class="wikitable"<br />
|-<br />
!Field name<br />
!Description<br />
|-<br />
|left_id<br />
|Primary key of the node on the left branch of the current node.<br />
|-<br />
|right_id<br />
|Primary key of the node on the right branch of the current node.<br />
|-<br />
|parent_id<br />
|Primary key of the parent node of the current node.<br />
|-<br />
|level<br />
|Number of steps from the root node to the current node.<br />
|-<br />
|path<br />
|Path from the root node to the current node.<br />
|-<br />
|alias<br />
|Optional. Alias name for the current node.<br />
|-<br />
|checked_out<br />
|Optional. As per [[JTable]].<br />
|-<br />
|checked_out_time<br />
|Optional. As per [[JTable]].<br />
|-<br />
|published<br />
|Optional. As per [[JTable]].<br />
|}<br />
<br />
===Methods===<br />
{| class="wikitable"<br />
|-<br />
!Method name<br />
!Description<br />
|-<br />
|[[JTableNested/delete|delete]]<br />
|Deletes a node, and optionally its child nodes, from the table.<br />
|-<br />
|[[JTableNested/getPath|getPath]]<br />
|Gets and array of nodes from the root to a given node.<br />
|-<br />
|[[JTableNested/getTree|getTree]]<br />
|Gets a node and all its child nodes.<br />
|-<br />
|[[JTableNested/isLeaf|isLeaf]]<br />
|Determines if a node is a leaf node in the tree (has no children).<br />
|-<br />
|[[JTableNested/move|move]]<br />
|Moves a node and its children to a new location in the tree.<br />
|-<br />
|[[JTableNested/orderDown|orderDown]]<br />
|Moves a node one position to the right in the same level.<br />
|-<br />
|[[JTableNested/orderUp|orderUp]]<br />
|Moves a node one position to the left in the same level.<br />
|-<br />
|[[JTableNested/publish|publish]]<br />
|Set the publishing state for a node or list of nodes in the table.<br />
|-<br />
|[[JTableNested/rebuildPath|rebuildPath]]<br />
|Rebuilds a node's path field from the alias values of the node from the current node to the root node of the tree.<br />
|-<br />
|[[JTableNested/setLocation|setLocation]]<br />
|Set the location of a node in the tree object.<br />
|-<br />
|[[JTableNested/store|store]]<br />
|Stores a node in the database table.<br />
|-<br />
|}<br />
===Importing===<br />
<source lang="php">jimport( 'joomla.database.tablenested' );</source><br />
<br />
===See also===<br />
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTableNested]]</noinclude></div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTableJTable2012-04-14T11:28:25Z<p>Bembelimen: Links angepasst</p>
<hr />
<div>'''JTable''' is an abstract class that forms the basis for all database table classes. Some of the methods listed will be overridden by the child class so you should check the child class documentation for further information.<br />
<br />
Each physical database table created should have a corresponding class derived from '''JTable''' to represent it. '''JTable''' provides many methods to make common manipulations to the table much simpler. For example, one of the most common operations you will need to perform is to read a table row into memory given a value for the primary key. This can be done easily using the [[/load|load]] method. The table row can then be just as easily updated using the [[/save|save]] method, which also performs any predefined sanity checks on the table fields.<br />
<br />
===Defined in===<br />
/joomla/database/table.php<br />
<br />
===Extends===<br />
* [[JObject]]<br />
<br />
===Extended by===<br />
* [[JTableARO]]<br />
* [[JTableAROGroup]]<br />
* [[JTableAsset]] (from 1.6)<br />
* [[JTableCategory]]<br />
* [[JTableComponent]]<br />
* [[JTableContent]]<br />
* [[JTableMenu]]<br />
* [[JTableMenuTypes]]<br />
* [[JTableModule]]<br />
* [[JTableNested]] (from 1.6)<br />
* [[JTablePlugin]]<br />
* [[JTableSection]]<br />
* [[JTableSession]]<br />
* [[JTableTree]] (from 1.6)<br />
* [[JTableUser]]<br />
<br />
===Reserved Database Field Names===<br />
Some of the optional features of JTable require the existence of specially-named fields in the database table. If you require this additional functionality you should ensure that these named fields are present in the table. These field names should be considered reserved as any attempts to use them for purposes other than those supported by JTable may result in conflict.<br />
{| class="wikitable"<br />
|-<br />
!Field name<br />
!Methods using the field name<br />
|-<br />
|checked_out<br />
|[[/checkOut|checkOut]], [[/checkIn|checkIn]], [[/isCheckedOut|isCheckedOut]]<br />
|-<br />
|checked_out_time<br />
|[[/checkOut|checkOut]], [[/checkIn|checkIn]], [[/isCheckedOut|isCheckedOut]]<br />
|-<br />
|hits<br />
|[[/hit|hit]]<br />
|-<br />
|ordering<br />
|[[/getNextOrder|getNextOrder]], [[/reorder|reorder]], [[/move|move]]<br />
|-<br />
|published<br />
|[[/publish|publish]]<br />
|}<br />
<br />
====Check-in/check-out====<br />
Joomla tables implement a simple mechanism for preventing a [[wikipedia:race condition|race condition]] while editing rows in a database. This depends on the existence of database fields called "checked_out" and "checked_out_time" and if these fields are present '''JTable''' will automatically support this mechanism so that it can be easily used in your tables too. In addition to the [[/checkOut|checkOut]] and [[/checkIn|checkIn]] methods, there is a [[/isCheckedOut|isCheckedOut]] method to determine if a given table row is currently checked out by another user.<br />
<br />
====Hit counter====<br />
Some Joomla tables contain a field called "hits" which records the number of times that a table row has been accessed. '''JTable''' provides a simple method to increment this field: [[/hit|hit]].<br />
<br />
====Ordering====<br />
Many Joomla tables support a user-defined ordering of the rows.<br />
<br />
To be written.<br />
<br />
====Publish/Unpublish====<br />
To be written.<br />
<br />
===Get and Set Methods===<br />
Properties which do not have specific get or set methods listed here can be retrieved or set using the inherited [[JObject/get|JObject->get]] method.<br />
{| class="wikitable"<br />
|-<br />
!Get method<br />
!Set method<br />
!Description<br />
|-<br />
|[[/getAssetNamePrefix|getAssetNamePrefix]]<br />
|<br />
|Abstract method to return the name prefix to use for the asset table. From 1.6.<br />
|-<br />
|[[/getAssetSection|getAssetSection]]<br />
|<br />
|Abstract method to return the access section name for the asset table. From 1.6.<br />
|-<br />
|[[/getAssetTitle|getAssetTitle]]<br />
|<br />
|Abstract method to return the title to use for the asset table. From 1.6.<br />
|-<br />
|[[/getDBO|getDBO]]<br />
|[[/setDBO|setDBO]]<br />
|Method to set/get the [[JDatabase|JDatabase]] connector object associated with the table.<br />
|-<br />
|[[/getTableName|getTableName]]<br />
|<br />
|Method to get the name of the database table.<br />
|-<br />
|[[/getKeyName|getTableKey]]<br />
|<br />
|Method to get the primary key field name for the table<br />
|}<br />
<br />
===Other Methods===<br />
{| class="wikitable"<br />
|-<br />
!Method name<br />
!Description<br />
|-<br />
|[[/__construct|construct]]<br />
|Object constructor to set table and key field<br />
|-<br />
|[[/addIncludePath|addIncludePath]]<br />
|Add a filesystem path where '''JTable''' should search for table class files.<br />
|-<br />
|[[/bind|bind]]<br />
|Binds an associative array or object to the '''JTable''' instance.<br />
|-<br />
|[[/canDelete|canDelete]]<br />
|Checks whether dependencies exist for this object in the database schema.<br />
|-<br />
|[[/check|check]]<br />
|Perform sanity checks on the '''JTable''' instance properties.<br />
|-<br />
|[[/checkin|checkin]]<br />
|Checks a row in if the necessary instance properties and table fields exist.<br />
|-<br />
|[[/checkout|checkout]]<br />
|Checks a row out if the necessary instance properties and table fields exist.<br />
|-<br />
|[[/delete|delete]]<br />
|Deletes a row from the database table by primary key value.<br />
|-<br />
|[[/getInstance|getInstance]]<br />
|Static method to get an instance of a '''JTable''' class.<br />
|-<br />
|[[/getNextOrder|getNextOrder]]<br />
|Gets the next ordering value for a group of rows defined by an SQL WHERE clause.<br />
|-<br />
|[[/hit|hit]]<br />
|Increments the hits for a row if the necessary instance property and table field exists.<br />
|-<br />
|[[/isCheckedOut|isCheckedOut]]<br />
|Determines if a row is checked out and therefore un-editable by a user.<br />
|-<br />
|[[/load|load]]<br />
|Loads a row from the database by primary key and binds the fields to the '''JTable''' instance properties.<br />
|-<br />
|[[/move|move]]<br />
|Moves a row in the ordering sequence of a group of rows defined by an SQL WHERE clause.<br />
|-<br />
|[[/publish|publish]]<br />
|Sets the publishing state for a row or list of rows in the database table.<br />
|-<br />
|[[/reorder|reorder]]<br />
|Compacts the ordering values of rows in a group of rows defined by an SQL WHERE clause.<br />
|-<br />
|[[/reset|reset]]<br />
|Resets class properties to the defaults set in the class definition.<br />
|-<br />
|[[/save|save]]<br />
|Provides a shortcut to binding, checking and storing a '''JTable''' instance to the database table.<br />
|-<br />
|[[/store|store]]<br />
|Stores a row in the database from the '''JTable''' instance properties.<br />
|-<br />
|[[/toXML|toXML]]<br />
|Exports the '''JTable''' instance properties to an XML string.<br />
|}<br />
===Importing===<br />
<source lang="php">jimport( 'joomla.database.table' );</source><br />
<br />
==Die JTable Klasse für neue Tabellen erweitern==<br />
Die JTable Klasse kann leicht erweitert werden, um jede Tabelle Ihrer Datenbank darzustellen.<br />
{{siehe auch|[[/Beispiele|Die JTable Klasse erweitern]]}}<br />
<br />
===See also===<br />
* [http://api.joomla.org/Joomla-Framework/Table/JTable.html JTable on api.joomla.org]<br />
* [[How to use the database classes in your script]]<br />
* [[Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface]]<br />
* [[How to connect to an external database]]<br />
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTable]]</noinclude></div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JDatabaseQueryJDatabaseQuery2012-04-14T11:25:27Z<p>Bembelimen: /* = Verketten */ Überschrift angepasst</p>
<hr />
<div>==Beschreibung==<br />
'''JDatabaseQuery''' vereinfacht des Erstellen von Datenbankqueries mit einer speziell dafür ausgelegten Klasse.<br />
<br />
==Definiert in==<br />
{{folder|/libraries/joomla}}<br />
*{{folder|database|red}}<br />
**{{file|databasequery.php|php}}<br />
<br />
==Status==<br />
* '''@since''' {{JVer|1.6}}<br />
<br />
==Importieren==<br />
Die Klasse muss nicht importiert werden, sondern kann einfach über die [[JDatabase]] Klasse bezogen werden.<br />
<br />
==Erweitert==<br />
* Keine<br />
<br />
==Wird erweitert von==<br />
* Keine<br />
<br />
==Methoden==<br />
{| class="wikitable"<br />
|-<br />
!Name<br />
!Beschreibung<br />
|-<br />
| [[/clear|clear]]<br />
| Setzt das gesamte Queryobjekt oder einen bestimmten Teil von ihm zurück.<br />
|-<br />
| [[/select|select]]<br />
| Setzt eine einzelne oder mehrere [http://dev.mysql.com/doc/refman/5.1/de/select.html SELECT-Anweisung] des Queries.<br />
|-<br />
| [[/delete|delete]]<br />
| Setzt die [http://dev.mysql.com/doc/refman/5.1/de/delete.html DELETE-Anweisung] des Queries.<br />
|-<br />
| [[/insert|insert]]<br />
| Setzt die [http://dev.mysql.com/doc/refman/5.1/de/insert.html INSERT-Anweisung] des Queries.<br />
|-<br />
| [[/update|update]]<br />
| Setzt die [http://dev.mysql.com/doc/refman/5.1/de/update.html UPDATE-Anweisung] des Queries.<br />
|-<br />
| [[/from|from]]<br />
| Bestimmt eine oder mehrere Tabellen auf denen der Query ausgeführt werden soll.<br />
|-<br />
| [[/join|join]]<br />
| Setzt einen [http://dev.mysql.com/doc/refman/5.0/en/join.html SQL JOIN] in dem Objekt.<br />
|-<br />
| [[/innerJoin|innerJoin]]<br />
| Vereinfacht den Aufruf von [[/join|JDatabaseQuery/join]].<br />
|-<br />
| [[/outerJoin|outerJoin]]<br />
| Vereinfacht den Aufruf von [[/join|JDatabaseQuery/join]].<br />
|-<br />
| [[/leftJoin|leftJoin]]<br />
| Vereinfacht den Aufruf von [[/join|JDatabaseQuery/join]].<br />
|-<br />
| [[/rightJoin|rightJoin]]<br />
| Vereinfacht den Aufruf von [[/join|JDatabaseQuery/join]].<br />
|-<br />
| [[/set|set]]<br />
|{{@todo|beschreibung}}<br />
|-<br />
| [[/where|where]]<br />
|{{@todo|beschreibung}}<br />
|-<br />
| [[/group|group]]<br />
|{{@todo|beschreibung}}<br />
|-<br />
| [[/having|having]]<br />
|{{@todo|beschreibung}}<br />
|-<br />
| [[/order|order]]<br />
|{{@todo|beschreibung}}<br />
|}<br />
<br />
== Beispiele ==<br />
<br />
=== Objekt erzeugen ===<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
/* Ein (leeres) JDatabaseQuery Objekt beziehen.<br />
Ohne Parameter wird das aktuelle Queryobjekt mit seinen Werten zurückgegeben */<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
=== Debuggen ===<br />
Bei der Übergabe an an die Datenbank und generell bei der Umwandlung des Objekts in eine Zeichenkette wird automatisch die [http://www.php.net/manual/de/language.oop5.magic.php#language.oop5.magic.tostring magische __toString() Methode] aufgerufen. Dies lässt sich auch zum Debuggen der Queries nutzen.<br />
<source lang="php"><br />
$query->from('#__tabelle AS t');<br />
$query->select('feld1 AS Feld');<br />
$query->select('feld2 AS Feld2');<br />
$query->where('id = '.(int)$id);<br />
$query->where('title = '.$db->quote('Der Titel'));<br />
<br />
echo '<pre>'.$query.'</pre>';<br />
</source><br />
Ausgabe:<br />
<pre><br />
SELECT t.feld1 AS Feld,t.feld2 AS Feld2<br />
FROM #__tabelle AS t<br />
WHERE t.id = 4711 AND t.title = 'Der Titel'<br />
</pre><br />
<br />
=== Verketten ===<br />
Da die Methoden von JDatabaseQuery immer 'sich selbst' zurück geben, kann man diese Methoden auch [http://www.php.de/wiki-php/index.php/Method_chaining verketten].<br />
<br />
<source lang="php"><br />
$query->select('t.feld1')->from('#__tabelle AS t');<br />
</source><br />
<br />
Bei längeren Queries kann man diese auch zur besseren Übersicht auf mehrere Zeilen verteilen.<br />
<br />
<source lang="php"><br />
$query<br />
->from('#__tabelle AS t')<br />
->select('t.feld1 AS Feld')<br />
->select('t.feld2 AS Feld2')<br />
->where('t.id = '.(int)$id)<br />
->where('t.title = '.$db->quote('Der Titel'));<br />
</source><br />
<br />
==Siehe auch==<br />
* {{@todo|404}}<tt>]h_ttp://api.joomla.org/Joomla-Framework/Database/JDatabaseQuery.html JDatabaseQuery]</tt> auf api.joomla.org<br />
[[JDatabase/getQuery|JDatabase::getQuery]]<br />
<br />
[[Kategorie:Experten]]<br />
[[Kategorie:Joomla! Programmierung]]<br />
[[Kategorie:Framework]]<br />
[[Kategorie:JDatabaseQuery]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JTable/saveJoomla! Programmierung/Framework/JTable/save2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/save“ nach „JTable/save“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JTable/save]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JTable/reorderJoomla! Programmierung/Framework/JTable/reorder2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/reorder“ nach „JTable/reorder“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JTable/reorder]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JTable/moveJoomla! Programmierung/Framework/JTable/move2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/move“ nach „JTable/move“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JTable/move]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JTable/loadJoomla! Programmierung/Framework/JTable/load2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/load“ nach „JTable/load“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JTable/load]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JTable/bindJoomla! Programmierung/Framework/JTable/bind2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/bind“ nach „JTable/bind“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JTable/bind]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JTable/addIncludePathJoomla! Programmierung/Framework/JTable/addIncludePath2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/addIncludePath“ nach „JTable/addIncludePath“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JTable/addIncludePath]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JTable/BeispieleJoomla! Programmierung/Framework/JTable/Beispiele2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/Beispiele“ nach „JTable/Beispiele“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JTable/Beispiele]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/Joomla!_Programmierung/Framework/JTableJoomla! Programmierung/Framework/JTable2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable“ nach „JTable“: Struktur angepasst</p>
<hr />
<div>#WEITERLEITUNG [[JTable]]</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTable/BeispieleJTable/Beispiele2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/Beispiele“ nach „JTable/Beispiele“: Struktur angepasst</p>
<hr />
<div>{{@todo|übersetzen}}<br />
<br />
[[Category:Development]]<br />
== Writing an extension of JTable ==<br />
<br />
The JTable class is an implementation of the [http://en.wikipedia.org/wiki/Active_record_pattern Active Record] design pattern. It is used throughout Joomla! for [http://en.wikipedia.org/wiki/Create,_read,_update_and_delete creating, reading, updating, and deleting] records in the database table.<br />
<br />
To use JTable, create an extension of the class. In this example, we have a database table containing recipes.<br />
<br />
<pre><br />
<?php<br />
<br />
defined('_JEXEC') or die();<br />
<br />
class TableRecipes extends JTable<br />
{<br />
var $id = null;<br />
var $ingredients = null;<br />
var $instructions = null;<br />
var $serves = null;<br />
var $difficulty = null;<br />
var $prep_time = null;<br />
var $cook_time = null;<br />
var $published = 0;<br />
<br />
function __construct(&$db)<br />
{<br />
parent::__construct( '#__recipes', 'id', $db );<br />
}<br />
}<br />
</pre><br />
<br />
When naming your class extension, the convention is to prefix it with 'Table', then follow with a [http://en.wikipedia.org/wiki/CamelCase CamelCased] version of the table's name. All of the member variables of your class should match the column names in the database. The default values should be valid according to the table schema For instance, if you have columns that are NOT NULL, you must use a value other than 'null' as the default.<br />
<br />
Finally, create a constructor for the class that accepts a reference to the current database instance. This will call the parent constructor which needs the name of the table, the name of the primary key column, and the database instance. The name of the table uses #__ instead of jos_, as the administrator can pick any table prefix desired during Joomla! installation.<br />
<br />
If you were using this class as a part of a component called 'Recipes', you would place this code in the file /administrator/components/com_recipes/tables/recipes.php.<br />
<br />
<br />
== Using a JTable class extension ==<br />
<br />
Once the table class is in place, you can use it in any Joomla! extension. To include the file, place this line in your extension's source code (use com_nameofyourcomponent in place of com_recipes):<br />
<br />
<pre><br />
JTable::addIncludePath(JPATH_ADMINISTRATOR.DS.'components'.DS.'com_recipes'.DS.'tables');<br />
</pre><br />
<br />
To get an instance of the object, use this code:<br />
<br />
<pre><br />
$row =& JTable::getInstance('recipes', 'Table');<br />
</pre><br />
<br />
Notice that the lowercase version of the suffix of your class name is used as the first parameter, with the prefix 'Table' as the second. Also, the getInstance() member function of JTable returns the object by reference instead of value; use =& to enforce this. <br />
<br />
In a model class (extends JModel) you can also use:<br />
<br />
<pre><br />
$row =& $this->getTable('recipes');<br />
</pre><br />
<br />
Notice that if you have not used the standard naming convention, you can supply the class prefix as the optional second parameter.<br />
<br />
=== Create/Update ===<br />
In a typical situation, you will have an HTML form submitted by the user which will PHP will interpret for you as an associative array. The JRequest class in Joomla! has functions ready to assist with retrieving this data safely. Use JRequest::get('post') to retrieve all of the elements in the HTTP POST request as a sanitized array.<br />
<br />
Once you have this array, you can pass it into the bind() method of JTable. Doing this will match the associated items of the array with member variables of the class. In the following example, the array is retrieved from JRequest::get('post') and immediately passed into bind(). <br />
<br />
<pre><br />
if (!$row->bind( JRequest::get( 'post' ) )) {<br />
return JError::raiseWarning( 500, $row->getError() );<br />
}<br />
</pre><br />
<br />
If bind() fails, you want to stop the application and explain the failure before your extension attempts to send the data. The raiseWarning() function of JError allows you to stop Joomla!, while the getError() function returns the error message stored in the JTable object.<br />
<br />
When binding succeeds and your object is ready, call the store() function. Again, if something goes wrong, stop the application and explain why.<br />
<br />
<pre><br />
if (!$row->store()) {<br />
JError::raiseError(500, $row->getError() );<br />
}<br />
</pre><br />
<br />
Notes:<br />
* If any member variables of your JTable object are null when store() is called, they are ignored by default. This allows you to update specific columns of your table, while leaving the others untouched. If you wish to override this behavior to ensure that all columns have a value, pass true into store().<br />
* The JTable::bind() and JRequest::get() functions do not enforce data types. If you need a column to be a specific type (for instance, integer), you need to add this logic to your code before calling store().<br />
<br />
=== Read ===<br />
To load a specific row of the database with JTable, pass the key into the load() member function.<br />
<br />
<pre><br />
$row->load( $id );<br />
</pre><br />
<br />
This relies on the key column you specified in the second parameter of parent::__construct() when you extended JTable.<br />
<br />
=== Delete ===<br />
Like read(), delete() allows you to destroy a specific row in the table based on the key specified earlier.<br />
<br />
<pre><br />
$row->delete( $id );<br />
</pre><br />
<br />
If you want to delete multiple rows at once, you will need to write the query manually.<br />
<br />
== Member Functions ==<br />
{{jfr summary|class=JTable|methods=yes}}<br />
<br />
== Summary ==<br />
When properly extended, JTable gives you all of the basic functions you need for managing and retrieving records in a database table. Member functions take care of the rest when you add member variables, the table name, and the key column.</div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTable/addIncludePathJTable/addIncludePath2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/addIncludePath“ nach „JTable/addIncludePath“: Struktur angepasst</p>
<hr />
<div>Adds a filesystem path where [[JTable]] should search for table class files. You may either pass a string or an array of paths. Duplicate paths are ignored. Paths are added to the front of the array so that custom paths are searched first.<br />
<br />
Returns the array of paths. Call addIncludePath with a null argument to get the current path array.<br />
===Syntax===<br />
array addIncludePath( $path )<br />
<br />
where:<br />
{| class="wikitable"<br />
!Argument<br />
!Data type<br />
!Description<br />
!Default<br />
|-<br />
|$path<br />
|string or array<br />
|A filesystem path or array of filesystem paths to add.<br />
|'''null'''<br />
|}<br />
<br />
===Example===<br />
Example required.<br />
<br />
===See also===<br />
* [http://api.joomla.org/Joomla-Framework/Table/JTable.html#addIncludePath JTable->addIncludePath on api.joomla.org]<br />
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTable]]</noinclude></div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTable/saveJTable/save2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/save“ nach „JTable/save“: Struktur angepasst</p>
<hr />
<div>{{@todo}}<br />
===Syntax===<br />
''boolean'' <nowiki> save ($source, $order_filter='', $ignore='')</nowiki><br />
<br />
=== Parameters ===<br />
{| class="wikitable"<br />
!Argument<br />
!Data type<br />
!Description<br />
!Default<br />
|-<br />
|$source<br />
|array<br />
|Source array for binding to class vars. See [[JTable/bind]].<br />
|<br />
|-<br />
|$order_filter<br />
|string<br />
|Filter for the order updating. See [[JTable/reorder]]<br />
|<nowiki>''</nowiki><br />
|-<br />
|$ignore<br />
|mixed<br />
|An array or space separated list of fields not to bind. See [[JTable/bind]].<br />
|<nowiki>''</nowiki><br />
|}<br />
<br />
=== Returns ===<br />
TRUE if completely successful, FALSE if partially or not succesful.<br />
<br />
=== Description ===<br />
JTable::save() - Combines several methods of the JTable Class.<br />
# Triggers the bind() method of the object, and binds the <code> $source </code> array to the object. See [[JTable/bind]]<br />
# Triggers the check() method of the object, and checks if all properties which have been previously been bound to the object are valid. See [[JTable/check]]<br />
# Triggers the store() method of the object, and updates the row defined by the table key, or inserts a new record if the value of the table key equals 0. See [[JTable/store]]<br />
# Triggers the checkin() method of the object (only if the table has the columns <code> checked_out </code> and <code> checked_out_time </code>). See [[JTable/checkin]]<br />
# If the <code>$order_filter</code> parameter is set, the reorder() method is triggered, compacting the ordering sequence of the selected records. The parameter <code>$order_filter</code> is used to create the <code> $where </code> parameter for the <code><nowiki>JTable::reorder($where='')</nowiki></code> method. See [[JTable/reorder]]<br />
=== Preconditions ===<br />
JTable is an abstract class. You need to write a child class, to use its functionality. See [[Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface#Creating the Table Class | Part 4 of the MVC Tutorial]]<br />
<br />
=== Source Code ===<br />
In this particular case a look on the source code is much more self-explainatory than any example.<br />
<br />
<source lang="php"><br />
function save( $source, $order_filter='', $ignore='' )<br />
{<br />
if (!$this->bind( $source, $ignore )) {<br />
return false;<br />
}<br />
if (!$this->check()) {<br />
return false;<br />
}<br />
if (!$this->store()) {<br />
return false;<br />
}<br />
if (!$this->checkin()) {<br />
return false;<br />
}<br />
if ($order_filter)<br />
{<br />
$filter_value = $this->$order_filter;<br />
$this->reorder( $order_filter ? $this->_db->nameQuote( $order_filter ).' = '.$this->_db->Quote( $filter_value ) : '' );<br />
}<br />
$this->setError('');<br />
return true;<br />
}<br />
</source><br />
==Quellcode==<br />
<jcodedisplay>JTable/save</jcodedisplay><br />
<br />
===See also===<br />
* [[Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface#Creating the Table Class | Creating a JTable Child Class (MVC Tutorial Part 4)]]<br />
* [http://api.joomla.org/Joomla-Framework/Table/JTable.html#save API Reference on JTable::save()]<br />
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTable]]</noinclude></div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTable/bindJTable/bind2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/bind“ nach „JTable/bind“: Struktur angepasst</p>
<hr />
<div>Method to bind an associative array or object to the [[JTable]] instance. This method only binds properties that are publicly accessible and optionally takes an array of properties to ignore when binding. Binding is the process where values are copied into their equivalently named instance properties (see examples).<br />
<br />
===Syntax===<br />
''boolean'' bind( $from, [$ignore = array()] ) <br />
<br />
=== Parameters ===<br />
{| class="wikitable"<br />
!Argument<br />
!Data type<br />
!Description<br />
!Default<br />
|-<br />
|$from<br />
|array or object<br />
|An associative array or object to be bind to the [[JTable]] instance.<br />
|<br />
|-<br />
|$ignore<br />
|array or string<br />
|An optional array or space separated list of properties to ignore while binding.<br />
|array()<br />
|}<br />
<br />
Returns '''true''' if bind was successful.<br />
<br />
===Example===<br />
In this example the class '''TableGreeting''' corresponds to a table called 'jos_greeting' in the Joomla database.<br />
<source lang="php"><br />
class TableGreeting extends JTable<br />
{<br />
var $id = null;<br />
var $greeting = null;<br />
var $language = null;<br />
var $_code = null;<br />
<br />
function __construct( &$db )<br />
{<br />
parent::__construct( '#__greeting', 'id', $db );<br />
}<br />
}<br />
</source><br />
<br />
Now, in the model, create an array of fields/properties to be updated and bind it to the table object:<br />
<source lang="php"><br />
// Create the array of new/amended fields/properties.<br />
$from = array( 'id' => 6,<br />
'greeting' => 'Nǐ hǎo',<br />
'language' => 'Chinese',<br />
'continent' => 'Asia'<br />
'_code' => 'ASC012'<br />
);<br />
// Specify which columns are to be ignored. This can be a string or an array.<br />
$ignore = 'id';<br />
<br />
// Get the table object from the model.<br />
$table = $this->getTable( 'greeting' );<br />
<br />
// Bind the array to the table object.<br />
$table->bind( $from, $ignore );<br />
<br />
// Show the result of the bind for illustration purposes only.<br />
echo '<pre>';<br />
print_r( $table );<br />
echo '</pre>';<br />
</source><br />
This would result in the following output:<br />
<source lang="text"><br />
TableGreeting Object<br />
(<br />
[id] => <br />
[greeting] => Nǐ hǎo<br />
[language] => Chinese<br />
[_code] =><br />
)<br />
</source><br />
Notice that<br />
* the 'continent' array entry has not been bound to the table object, since 'continent' is not a property of the object.<br />
* the 'id' array entry has not been bound to the table object either, since 'id' was on the ignore list.<br />
* the '_code' array entry has not been bound to the table because it is a private property of the table object (its name begins with an underscore).<br />
<br />
===See also===<br />
* [http://api.joomla.org/Joomla-Framework/Table/JTable.html#bind JTable->addIncludePath on api.joomla.org]<br />
* [[JTable/load|JTable->load]]<br />
* [[JTable/store|JTable->store]]<br />
* [[Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface#Creating the Table Class | Creating a JTable Child Class (MVC Tutorial Part 4)]]<br />
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTable]]</noinclude></div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTable/loadJTable/load2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/load“ nach „JTable/load“: Struktur angepasst</p>
<hr />
<div>{{review}}<br />
===Syntax===<br />
''void'' load ($oid = NULL) <br />
<br />
=== Parameters ===<br />
{| class="wikitable"<br />
!Argument<br />
!Data type<br />
!Description<br />
!Default<br />
|-<br />
|$oid<br />
|integer<br />
|Optional primary key. If not specifed, the value of current key is used.<br />
|''NULL''<br />
|}<br />
<br />
=== Returns ===<br />
nothing<br />
<br />
=== Description ===<br />
JTable::load() - Loads a row from the database and binds the fields to the object properties.<br />
=== Preconditions ===<br />
JTable is an abstract class. You need to write a child class, to use its functionality. See [[Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface#Creating the Table Class | Part 4 of the MVC Tutorial]]<br />
<br />
===Example===<br />
Let's say we have a table, that stores greetings of different languages:<br />
{| class="wikitable"<br />
!id<br />
!greeting<br />
!language<br />
|-<br />
|1<br />
|Hello<br />
|English<br />
|-<br />
|2<br />
|Bonjour<br />
|French<br />
|-<br />
|3<br />
|Guten Tag<br />
|German<br />
|}<br />
<br />
If we'd like to load the record with the id #3, we can call the table object from within the model, and load the record:<br />
<source lang="php"><br />
$table = $this->getTable('greeting');<br />
$table->load(3);<br />
echo '<pre>';<br />
print_r($table);<br />
echo '</pre>';<br />
<br />
/* RETURNS:<br />
TableGreeting Object<br />
(<br />
[id] => 3<br />
[greeting] => Guten Tag<br />
[language] => German<br />
)<br />
<br />
*/<br />
</source><br />
<br />
===See also===<br />
* [[JTable/bind]]<br />
* [[Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface#Creating the Table Class | Creating a JTable Child Class (MVC Tutorial Part 4)]]<br />
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTable]]</noinclude></div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTable/moveJTable/move2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/move“ nach „JTable/move“: Struktur angepasst</p>
<hr />
<div>{{review}}<br />
===Syntax===<br />
''void'' move ($dirn, [$where = '']) <br />
<br />
=== Parameters ===<br />
{| class="wikitable"<br />
!Argument<br />
!Data type<br />
!Description<br />
!Default<br />
|-<br />
|$dirn<br />
|integer<br />
|Direction to move the record. $dirn < 0 for up, $dirn > 0 for down.<br />
|<br />
|-<br />
|$where<br />
|string<br />
|Additional where query to limit ordering to a particular subset of records<br />
|<br />
|}<br />
<br />
=== Returns ===<br />
nothing<br />
<br />
=== Preconditions ===<br />
Your database table must have a column named 'ordering'.<br />
<br />
=== What does the method do? ===<br />
The goal of the method is to move a record of the table one step up, or one step down by switching the ordering values with the respective neighbour.<br />
===Example===<br />
Let's say we have the following database-table:<br />
{| class="wikitable"<br />
!id<br />
!greeting<br />
!ordering<br />
|-<br />
|1<br />
|Hello<br />
|5<br />
|-<br />
|2<br />
|Bonjour<br />
|15<br />
|-<br />
|3<br />
|Guten Tag<br />
|3<br />
|-<br />
|4<br />
|Buenos Días<br />
|10<br />
|-<br />
|5<br />
|Nǐ hǎo<br />
|17<br />
|}<br />
We now want to move down the entry 'Hello' one step.<br />
<source lang="php"><br />
//We need an instance of the table object. In a controller or model we can do it like this...<br />
$table = $this->getTable('greeting');<br />
//We need to load the 'Hello' entry into the table object. The id (which is the primary key of the table) of this entry is 1.<br />
$table->load(1);<br />
//We now want to move the 'Hello' entry one step down. That means, the $dirn Parameter must be positive.<br />
//We choose the value 1, but it could also be any other positive number<br />
$table->move(1);<br />
</source><br />
The first thing the method does is to load the record which has the next higher ordering value. (If our $dirn paremeter would have been negative, it would have loaded the record with the next lower ordering value. In our case, this is the record with the id #4.<br />
{| class="wikitable"<br />
!id<br />
!greeting<br />
!ordering<br />
|-<br />
|4<br />
|Buenos Días<br />
|10<br />
|}<br />
The next (and last step) is that the method switches the ordering values of both records. <br />
<br />
'''Before:'''<br />
{| class="wikitable"<br />
!id<br />
!greeting<br />
!ordering<br />
|-<br />
|1<br />
|Hello<br />
|5<br />
|-<br />
|4<br />
|Buenos Días<br />
|10<br />
|}<br />
'''After:'''<br />
{| class="wikitable"<br />
!id<br />
!greeting<br />
!ordering<br />
|-<br />
|1<br />
|Hello<br />
|10<br />
|-<br />
|4<br />
|Buenos Días<br />
|5<br />
|}<br />
<br />
In the end the table looks like this:<br />
<br />
{| class="wikitable"<br />
!id<br />
!greeting<br />
!ordering<br />
|-<br />
|1<br />
|Hello<br />
|10<br />
|-<br />
|2<br />
|Bonjour<br />
|15<br />
|-<br />
|3<br />
|Guten Tag<br />
|3<br />
|-<br />
|4<br />
|Buenos Días<br />
|5<br />
|-<br />
|5<br />
|Nǐ hǎo<br />
|17<br />
|}<br />
<br />
===See also===<br />
* [[JTable/reorder]]<br />
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTable]]</noinclude></div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTable/reorderJTable/reorder2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable/reorder“ nach „JTable/reorder“: Struktur angepasst</p>
<hr />
<div>{{review}}<br />
===Syntax===<br />
''void'' reorder ([string $where = ''])<br />
<br />
where:<br />
{| class="wikitable"<br />
!Argument<br />
!Data type<br />
!Description<br />
!Default<br />
|-<br />
|$where<br />
|string<br />
|Additional where query to limit ordering to a particular subset of records<br />
|''<br />
|}<br />
<br />
=== Preconditions ===<br />
Your database table must have a column named 'ordering'.<br />
<br />
=== What does the method do? ===<br />
The goal of the method is to compact the ordering sequence of the selected records. To do this, the method loads all records of the table (or just those that have been defined in the 'where'-clause. It then resets the ordering of all records in such a way that the ordering is continious.<br />
===Example===<br />
Let's say we have the following database-table:<br />
{| class="wikitable"<br />
!id<br />
!greeting<br />
!ordering<br />
|-<br />
|1<br />
|Hello<br />
|5<br />
|-<br />
|2<br />
|Bonjour<br />
|15<br />
|-<br />
|3<br />
|Guten Tag<br />
|3<br />
|}<br />
We now want to compress the ordering of the table.<br />
<source lang="php"><br />
//We need an instance of the table object. In a controller or model we can do it like this...<br />
$table = $this->getTable('greeting');<br />
//Let's compact the ordering sequence<br />
$table->reorder();<br />
</source><br />
The first thing the method does is to load the table ordered by the current ordering:<br />
{| class="wikitable"<br />
!id<br />
!greeting<br />
!ordering<br />
|-<br />
|3<br />
|Guten Tag<br />
|3<br />
|-<br />
|1<br />
|Hello<br />
|5<br />
|-<br />
|2<br />
|Bonjour<br />
|15<br />
|}<br />
The next (and last step) is that the method updates the ordering entries so it's a consecutive sequence:<br />
{| class="wikitable"<br />
!id<br />
!greeting<br />
!ordering<br />
|-<br />
|3<br />
|Guten Tag<br />
|1<br />
|-<br />
|1<br />
|Hello<br />
|2<br />
|-<br />
|2<br />
|Bonjour<br />
|3<br />
|}<br />
<br />
===See also===<br />
* [[JTable/move]]<br />
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTable]]</noinclude></div>Bembelimenhttp://www.joomla-wiki.de/dokumentation/JTableJTable2012-04-14T11:24:40Z<p>Bembelimen: verschob „Joomla! Programmierung/Framework/JTable“ nach „JTable“: Struktur angepasst</p>
<hr />
<div>'''JTable''' is an abstract class that forms the basis for all database table classes. Some of the methods listed will be overridden by the child class so you should check the child class documentation for further information.<br />
<br />
Each physical database table created should have a corresponding class derived from '''JTable''' to represent it. '''JTable''' provides many methods to make common manipulations to the table much simpler. For example, one of the most common operations you will need to perform is to read a table row into memory given a value for the primary key. This can be done easily using the [[JTable/load|load]] method. The table row can then be just as easily updated using the [[JTable/save|save]] method, which also performs any predefined sanity checks on the table fields.<br />
<br />
===Defined in===<br />
/joomla/database/table.php<br />
<br />
===Extends===<br />
* [[JObject]]<br />
<br />
===Extended by===<br />
* [[Joomla! Programmierung/Framework/JTableARO|JTableARO]]<br />
* [[Joomla! Programmierung/Framework/JTableAROGroup|JTableAROGroup]]<br />
* [[Joomla! Programmierung/Framework/JTableAsset|JTableAsset]] (from 1.6)<br />
* [[Joomla! Programmierung/Framework/JTableCategory|JTableCategory]]<br />
* [[Joomla! Programmierung/Framework/JTableComponent|JTableComponent]]<br />
* [[Joomla! Programmierung/Framework/JTableContent|JTableContent]]<br />
* [[Joomla! Programmierung/Framework/JTableMenu|JTableMenu]]<br />
* [[Joomla! Programmierung/Framework/JTableMenuTypes|JTableMenuTypes]]<br />
* [[Joomla! Programmierung/Framework/JTableModule|JTableModule]]<br />
* [[Joomla! Programmierung/Framework/JTableNested|JTableNested]] (from 1.6)<br />
* [[Joomla! Programmierung/Framework/JTablePlugin|JTablePlugin]]<br />
* [[Joomla! Programmierung/Framework/JTableSection|JTableSection]]<br />
* [[Joomla! Programmierung/Framework/JTableSession|JTableSession]]<br />
* [[Joomla! Programmierung/Framework/JTableTree|JTableTree]] (from 1.6)<br />
* [[Joomla! Programmierung/Framework/JTableUser|JTableUser]]<br />
<br />
===Reserved Database Field Names===<br />
Some of the optional features of JTable require the existence of specially-named fields in the database table. If you require this additional functionality you should ensure that these named fields are present in the table. These field names should be considered reserved as any attempts to use them for purposes other than those supported by JTable may result in conflict.<br />
{| class="wikitable"<br />
|-<br />
!Field name<br />
!Methods using the field name<br />
|-<br />
|checked_out<br />
|[[Joomla! Programmierung/Framework/JTable/checkOut|checkOut]], [[Joomla! Programmierung/Framework/JTable/checkIn|checkIn]], [[Joomla! Programmierung/Framework/JTable/isCheckedOut|isCheckedOut]]<br />
|-<br />
|checked_out_time<br />
|[[Joomla! Programmierung/Framework/JTable/checkOut|checkOut]], [[Joomla! Programmierung/Framework/JTable/checkIn|checkIn]], [[Joomla! Programmierung/Framework/JTable/isCheckedOut|isCheckedOut]]<br />
|-<br />
|hits<br />
|[[Joomla! Programmierung/Framework/JTable/hit|hit]]<br />
|-<br />
|ordering<br />
|[[Joomla! Programmierung/Framework/JTable/getNextOrder|getNextOrder]], [[Joomla! Programmierung/Framework/JTable/reorder|reorder]], [[Joomla! Programmierung/Framework/JTable/move|move]]<br />
|-<br />
|published<br />
|[[Joomla! Programmierung/Framework/JTable/publish|publish]]<br />
|}<br />
<br />
====Check-in/check-out====<br />
Joomla tables implement a simple mechanism for preventing a [[wikipedia:race condition|race condition]] while editing rows in a database. This depends on the existence of database fields called "checked_out" and "checked_out_time" and if these fields are present '''JTable''' will automatically support this mechanism so that it can be easily used in your tables too. In addition to the [[JTable/checkOut|checkOut]] and [[JTable/checkIn|checkIn]] methods, there is a [[JTable/isCheckedOut|isCheckedOut]] method to determine if a given table row is currently checked out by another user.<br />
<br />
====Hit counter====<br />
Some Joomla tables contain a field called "hits" which records the number of times that a table row has been accessed. '''JTable''' provides a simple method to increment this field: [[Joomla! Programmierung/Framework/JTable/hit|hit]].<br />
<br />
====Ordering====<br />
Many Joomla tables support a user-defined ordering of the rows.<br />
<br />
To be written.<br />
<br />
====Publish/Unpublish====<br />
To be written.<br />
<br />
===Get and Set Methods===<br />
Properties which do not have specific get or set methods listed here can be retrieved or set using the inherited [[JObject/get|JObject->get]] method.<br />
{| class="wikitable"<br />
|-<br />
!Get method<br />
!Set method<br />
!Description<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/getAssetNamePrefix|getAssetNamePrefix]]<br />
|<br />
|Abstract method to return the name prefix to use for the asset table. From 1.6.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/getAssetSection|getAssetSection]]<br />
|<br />
|Abstract method to return the access section name for the asset table. From 1.6.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/getAssetTitle|getAssetTitle]]<br />
|<br />
|Abstract method to return the title to use for the asset table. From 1.6.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/getDBO|getDBO]]<br />
|[[Joomla! Programmierung/Framework/JTable/setDBO|setDBO]]<br />
|Method to set/get the [[Joomla! Programmierung/Framework/JDatabase|JDatabase]] connector object associated with the table.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/getTableName|getTableName]]<br />
|<br />
|Method to get the name of the database table.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/getKeyName|getTableKey]]<br />
|<br />
|Method to get the primary key field name for the table<br />
|}<br />
<br />
===Other Methods===<br />
{| class="wikitable"<br />
|-<br />
!Method name<br />
!Description<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/__construct|construct]]<br />
|Object constructor to set table and key field<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/addIncludePath|addIncludePath]]<br />
|Add a filesystem path where '''JTable''' should search for table class files.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/bind|bind]]<br />
|Binds an associative array or object to the '''JTable''' instance.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/canDelete|canDelete]]<br />
|Checks whether dependencies exist for this object in the database schema.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/check|check]]<br />
|Perform sanity checks on the '''JTable''' instance properties.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/checkin|checkin]]<br />
|Checks a row in if the necessary instance properties and table fields exist.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/checkout|checkout]]<br />
|Checks a row out if the necessary instance properties and table fields exist.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/delete|delete]]<br />
|Deletes a row from the database table by primary key value.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/getInstance|getInstance]]<br />
|Static method to get an instance of a '''JTable''' class.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/getNextOrder|getNextOrder]]<br />
|Gets the next ordering value for a group of rows defined by an SQL WHERE clause.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/hit|hit]]<br />
|Increments the hits for a row if the necessary instance property and table field exists.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/isCheckedOut|isCheckedOut]]<br />
|Determines if a row is checked out and therefore un-editable by a user.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/load|load]]<br />
|Loads a row from the database by primary key and binds the fields to the '''JTable''' instance properties.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/move|move]]<br />
|Moves a row in the ordering sequence of a group of rows defined by an SQL WHERE clause.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/publish|publish]]<br />
|Sets the publishing state for a row or list of rows in the database table.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/reorder|reorder]]<br />
|Compacts the ordering values of rows in a group of rows defined by an SQL WHERE clause.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/reset|reset]]<br />
|Resets class properties to the defaults set in the class definition.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/save|save]]<br />
|Provides a shortcut to binding, checking and storing a '''JTable''' instance to the database table.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/store|store]]<br />
|Stores a row in the database from the '''JTable''' instance properties.<br />
|-<br />
|[[Joomla! Programmierung/Framework/JTable/toXML|toXML]]<br />
|Exports the '''JTable''' instance properties to an XML string.<br />
|}<br />
===Importing===<br />
<source lang="php">jimport( 'joomla.database.table' );</source><br />
<br />
==Die JTable Klasse für neue Tabellen erweitern==<br />
Die JTable Klasse kann leicht erweitert werden, um jede Tabelle Ihrer Datenbank darzustellen.<br />
{{siehe auch|[[Joomla!_Programmierung/Framework/JTable/Beispiele|Die JTable Klasse erweitern]]}}<br />
<br />
===See also===<br />
* [http://api.joomla.org/Joomla-Framework/Table/JTable.html JTable on api.joomla.org]<br />
* [[How to use the database classes in your script]]<br />
* [[Developing a Model-View-Controller Component - Part 4 - Creating an Administrator Interface]]<br />
* [[How to connect to an external database]]<br />
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JTable]]</noinclude></div>Bembelimen