Inhaltselement programmieren oder erweitern

[maxi62]

Hallo,
gibt es irgendwo ein Tutorial oder eine Erklärung wie man ein neues Inhaltselement programmiert?
Schön wäre ein leeres Grundgerüst!

Und wie man ein vorhandenes Inhaltselement um weitere Features erweitert? Zum Beispiel wenn ich das Inhaltselement Download so ergänzen möchte, das es nur dann sichtbar ist wenn eine Bedingung erfüllt ist. Ist die Bedingung nicht erfüllt möchte ich statt der Datei anderen Text anzeigen.

[Sarvo]

Hi


hier gibt es ein Hello World Tutorial. Darauf kannst du ganz schön aufbauen. Ansonsten schau dich mal weiter auf der Seite um, dort findest du noch mehr Tutorials.

Dort sind auch Tutorials wie du vorhande Module erweiterst.

[maxi62]

Hi


hier gibt es ein Hello World Tutorial. Darauf kannst du ganz schön aufbauen. Ansonsten schau dich mal weiter auf der Seite um, dort findest du noch mehr Tutorials.

Dort sind auch Tutorials wie du vorhande Module erweiterst.

Dort wird leider nur erläutert wie man Module erstellt und erweitert, aber nicht wie man Inhaltselemente (für Artikel) erstellt oder erweitert.

[Toflar]

Ich hab's gelernt, in dem ich mir einfach den TL-Core angeschaut habe. Dann ist es am einfachsten nachzuvollziehen und es gibt keine bessere Doku als TL als System selbst

Ausserdem gibt's für einfache Anforderungen den ce_designer von lindesbs als Erweiterung. Damit kann man sich sehr einfach selber CE's machen

[FloB]

Template nicht vergessen!

[Toflar]

Template nicht vergessen!

Motzt TL ja eh, wenn's nicht da ist

[maxi62]

Das sagt ihr alles so leicht. Am Anfang ist das garnicht so einfach.
Toll wäre noch ein Generator für eigene Contents. So was wie ce_designer, aber unabhängig von Formularen.

[Toflar]

Wie das sagt ihr alles so leicht? Ist es doch auch? Also ein CE-Element zumindest?

Anleitung steht ja von leo-unglaub sogar noch da An was scheiterts denn?

PS: Ich setze php und grundlegende OOP-Kenntnisse ja eh voraus, ansonsten ist die Frage wie man das macht ja überflüssig

[andre.5tz]

Sowas vielleicht?

[development] Entwickler-Tools

[Toflar]

Damit lässt sich nur die grundlegende Modul-Struktur erstellen, nicht aber ein fixfertiges CE

[maxi62]

Sowas vielleicht?

[development] Entwickler-Tools

Ja, nur das er noch Beispielcontent erstellt.

Wenn das alles so einfach ist, warum erstellt ihr dann nicht einfach mal ein Dummy-Content mit Eingabefeld für DummyÜberschrift und DummyText. Packt das in eine Zip und stellt es ins Wiki! Damit kommt man dann schon ein Stück weiter denk ich.

[xtra]

Sowas vielleicht?
[development] Entwickler-Tools

Sei mir nicht boese, aber die Erweiterung erzeugt (fuer einen Programmierer) mehr Fallstricke als sie loest.

Man sollte lieber selbst Hand anlegen und von etwas bestehendem ableiten oder aber seine Klassen von Grund auf selbst bauen.

[andre.5tz]

Wieso sollte ich jemandem böse sein? Ich wollte nur auf eine weitere Möglichkeit hinweisen, dies ohne jeglichen Hinweis auf Qualität, die Einfachheit oder sonstiges

[Toflar]

Sei mir nicht boese, aber die Erweiterung erzeugt (fuer einen Programmierer) mehr Fallstricke als sie loest.

Man sollte lieber selbst Hand anlegen und von etwas bestehendem ableiten oder aber seine Klassen von Grund auf selbst bauen.

Ich mag's Für die Grundstruktur einfach...anpassen muss man aber eh immer noch einiges, das ist klar

[maxi62]

Also ich versuch gerade mal ein eigenes erstes Inhaltselement hin zu bekommen.
Ich hab erstmal die tl_content.php fertig gemacht. Vielleicht schaut ihr mal rein ob das soweit richtig ist:

<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');

/**
 * Table tl_content
 */

$GLOBALS['TL_DCA']['tl_content']['palettes']['fb_downloadartikel'] = '{type_legend},type,headline;{recommendation_legend},fb_downloadartikel_artikelname,fb_downloadartikel_artikelbeschreibung,
fb_downloadartikel_nummer,fb_downloadartikel_preis,fb_downloadartikel_paypalemail;{protected_legend:hide},protected;{expert_legend},{expert_legend:hide},guests,cssID,space';


$GLOBALS['TL_DCA']['tl_content']['fields']['fb_downloadartikel_artikelname'] = array
(
	'label'                   => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_artikelname'],
	'default'                 => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_artikelname_text'],
	'exclude'                 => true,
	'inputType'               => 'text',
	'eval'                    => array('mandatory'=>true, 'allowHtml' => false, 'tl_class'=>'w32')
);

$GLOBALS['TL_DCA']['tl_content']['fields']['fb_downloadartikel_artikelbeschreibung'] = array
(
	'label'                   => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_artikelbeschreibung'],
	'default'                 => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_artikelbeschreibung_text'],
	'exclude'                 => true,
	'inputType'               => 'textarea',
	'eval'                    => array('mandatory'=>true, 'allowHtml' => false, 'rows' => 10, 'cols' => 80, 'tl_class'=>'long')
);


$GLOBALS['TL_DCA']['tl_content']['fields']['fb_downloadartikel_nummer'] = array
(
	'label'                   => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_nummer'],
	'default'                 => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_nummer_text'],
	'exclude'                 => true,
	'inputType'               => 'text',
	'eval'                    => array('mandatory'=>true, 'allowHtml' => false, 'tl_class'=>'w10')
);

$GLOBALS['TL_DCA']['tl_content']['fields']['fb_downloadartikel_preis'] = array
(
	'label'                   => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_preis'],
	'default'                 => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_preis_text'],
	'exclude'                 => true,
	'inputType'               => 'text',
	'eval'                    => array('mandatory'=>true, 'allowHtml' => false, 'tl_class'=>'w10')
);

$GLOBALS['TL_DCA']['tl_content']['fields']['fb_downloadartikel_paypalemail'] = array
(
	'label'                   => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_fb_downloadartikel_paypalemail'],
	'default'                 => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_paypalemail_text'],
	'exclude'                 => true,
	'inputType'               => 'text',
	'eval'                    => array('mandatory'=>true, 'allowHtml' => false, 'tl_class'=>'w100')


/**
 * Class tl_content_fb_downloadartikel
 *
 * inhaltselement Dowenload-Artikel der per Paypal freigeschaltet wird
 * @copyright  maxi62 2009
 * @author     maxi62 2009
 * @package    ???
 */
 
class tl_content_fb_downloadartikel extends Backend
{
}

?>

Ich brauche darin auch noch ein Feld zum Auswähllen einer Datei, wie muss ich das denn definieren?

[maxi62]

Ich habe jetzt mal mein Inhaltselement also die Modulstruktur zu den anderen Modulen auf den Server kopiert.
Verwenden kann ich es auch. Aber es erscheint nicht in der Erweiterungsverwaltung, ist das normal?

[FloB]

Die Erweiterungsverwaltung zeigt nur solche an, die über das Repository installiert wurden. Alles händische wird ignoriert.

[maxi62]

Die Erweiterungsverwaltung zeigt nur solche an, die über das Repository installiert wurden. Alles händische wird ignoriert.

Aha, dann stimmts soweit. Nu muss ich nur noch rausbekommen wie ich ein Feld für Dateiauswahl hin bekomme.

[Toflar]

Hier ist der ganze DCA beschrieben: https://contao.org/referenz.html

Aber durchsuch am besten den TL Core nach "fileTree", dann siehst du sofort, wie der Hase läuft

[maxi62]

Ganz schön verzwickt.
Ich dachte es geht mit:

$GLOBALS['TL_DCA']['tl_content']['fields']['fb_downloadartikel_dateiurl'] = array
(
	'label'                   => &$GLOBALS['TL_LANG']['tl_content']['fb_downloadartikel_dateiurl'],
	'exclude'                 => true,
	'inputType'               => 'fileTree',
	'eval'                    => array('files'=>false, 'fieldType'=>'radio', 'mandatory'=>true)
);

Aber irgendwie werden damit nicht alle Dateien zur Auswahl gestellt. Wie kann ich Dateien aus bestimmten Ordner zur Auswahl vorgeben?

[maxi62]

Ok, das mit der Dateiauswahl hab ich nun hin bekommen.
Jetzt hab ich relativen Dateipfad.
Wo kann ich die Url der Webseite in PHP abfragen?

Und wie kann ich nun diese Datei als Downloadlink bereitstellen ohne das ich direkten Link verrate. Die Datei ist in geschützten Verzeichnis.

[FloB]

Und wie kann ich nun diese Datei als Downloadlink bereitstellen ohne das ich direkten Link verrate. Die Datei ist in geschützten Verzeichnis.

Schau dir mal Controller::sendFileToBrowser() an. Da Module (und AFAIK auch CEs) von Controller abgeleitet werden, kannst du einfach

$this->sendFileToBrowser('tl_files/datei.ext'); 

direkt in der generate()- bzw. compile()-Methode aufrufen. Damit der Schutz vollständig ist, sollte das Verzeichnis, das die Dateien enthält, per .htaccess gesperrt werden (Schloss in der Dateiverwaltung).

[maxi62]

Danke, das werde ich morgen ausprobieren.
Eins noch: Hab ich in der Compile-Funktion Zugriff auf dei globalen Post Variablen? Und wie erfahre ich die aktuell ausgeführte Url damit ich Script mit einem Paramter verlinken kann.

[Toflar]

Hallo !
Der Zugriff auf die POST-Variablen hast du über $this->Input->get();

Die URL ist da egal, da macht TL von selbst. Ansonsten ermittelst du die Adesse über die Classe Environment.

Viele GRüße
Leo

$this->Input->post()

URL: $this->Environment->base

[FloB]

Psst, nicht alles vorsagen, sonst lernt er nichts .

Allgemein kannst du dir die API von TYPOlight anschauen. Mit ein wenig Verständnis findest du dort immer, was du suchst. Beachte auch immer die Vererbung!
Und natürlich kannst und sollst du immer den TYPOlight Core anschauen, da lernst du wohl am meisten.


Edit: Wie wäre es mit einem Beginners' Guide (Tutorial), das wichtige Infos für beginnende Programmierer enthält?

[Toflar]

Beginners TL Guide ja, PHP Beginners Guide, nein

[FloB]

Natürlich nicht PHP, Kenntnisse in PHP OOP werden natürlich vorausgesetzt.
Quasi als Zusammenschau der wichtigen Funktionen und Vorgehensweisen zur TYPOlight-Programmierung (dabei meine ich nicht die Benutzung des Extension-Generators).

[maxi62]

Mit PHP komme ich schon einigermaßen klar, bin nur etwas aus der Übung da ich 1 Jahr nix mehr gemacht hab und auch Klassen nicht so oft einsetze. Nur halt die TL-Struktur und API ist mir halt noch ziemlich unklar.

Erstmal danke für die vielen Tipps, hat mir alles geholfen.
Aber wo finde ich denn Beispielsweise die Klasse Environment beschrieben, hab nirgends darüber was gefunden? Oder gehört heute zu PHP-Basis?

Ich will jetzt einen Link auf die aktuelle Seite setzen, bei dessen Ausführung ich anderen Inhalt ausgeben will. So in der Art wie:
http://www.meineurl.de/meineseite?do=meinaction
Wo steht nun der Link der aktuellen Seite. Vielleicht in "this->action" ?

[maxi62]

Du verstehst mich falsch. Ich will einen Link im Frontend ausgeben. Sobald der Link geklickt wird, möchte ich die Ausgabe in meinem Inhaltselement ändern. Daher muss der Link auf gleiche Seite zeigen und mein Script die Parameter auswerten.
Also quasi das gleiche als wenn ich ein kleines Formular ausgebe und bei Eingabe auswerten möchte.

[FloB]

Aber wo finde ich denn Beispielsweise die Klasse Environment beschrieben, hab nirgends darüber was gefunden?

Das liegt daran, dass die in einem anderen Bereich liegen … schau dir mal das Dropdown rechts oben an. Environment müsste in "libraries" stehen.

[maxi62]

Noch eine Unklarheit. Wenn ich mir so die Modulscripte anschaue, dann finde ich dort oft eine SQL Abfrage mit "Id=?" .
Zum Beispiel:

$objPage = $this->Database->prepare("SELECT id, alias FROM tl_page WHERE id=?")							  ->limit(1)
	  ->execute($this->disclaimer_thanks);

Mir ist nicht so recht klar was diese Bedingung (WHERE id=?") tut?

[maxi62]

Ich erzeuge in meinem Inhaltselement einen Freischaltlink auf folgende Weise:

$this->Template->freischaltlink = $this->Environment->request . "?fbdownloadartikel_do=freischalten";

Funktioniert auch, Ist das ok, oder ist das in typolight anders besser.

Zweitens: Wo speichert man am besten Grafiken für Module bzw. Content-Modul? Hab die bislang im Modul-Template-Verzeichnis!

[Toflar]

Das & solltest du durch ein & ersetzen.

Bilder, JS etc. speichern wir allgemein in einem Ordner 'html' im Modulverzeichnis

[maxi62]

Das & solltest du durch ein & ersetzen.

Bilder, JS etc. speichern wir allgemein in einem Ordner 'html' im Modulverzeichnis

Aber ich hab doch garkein & verwendet ??? Sondern nur "?"

[Toflar]

Äh sorry...frag mich bitte nicht wo ich meine Augen hatte, als ich das & gesehen hab

[maxi62]

Nun ich will nicht alles vollmüllen, daher nicht für jede Frage ein Thread!
Ich möchte im Modul eine Logdatei schreiben, dazu brauch ich Schreibberechtigung. Normalerweise setze ich die mit dem FTP-Programm.
Wie ist das bei Modulen, wo sollten die Log's ablegen und wie können Sie automatisch Schreibberechtigung erlangen, um Installation zu erleichtern?

[xtra]

Ich verwende dazu:

        $this->objLog = new File('system/logs/custom.log');
        $this->objLog->append('Log started'); 

Hab aber keine Ahnung ob das mit SMH auch funktioniert, da ich nur zu Testzwecken logge.

[maxi62]

Was ist denn SMH?

Was mir noch etwas unklar ist, warum kann ich in Modulen nur ein Template verwenden.
Es wird ja in der Klasse festgelegt mit

protected $strTemplate = 'ce_fb_downloadartikel';

Warum kann ich es in der Compile Funktion mit $this->strTemplate="anderestemplate" nicht ändern falls eine Bedingung das erfordert?

[xtra]

Aeh, kannst du doch, du musst dann nur das Template Objekt neu erzeugen.

    protected $strTemplate = 'mod_meins';
    // [...]
    protected function compile()
    {
        if($this->irgendwaspassiert())
        {
            $this->strTemplate='mod_meinanderes';
            $this->Template = new FrontendTemplate($this->strTemplate);
        }
        // hier dann weiter
    } 

[FloB]

Es gibt eine extra Logging-Funktion, die die Logs in /system/logs/ schreibt:

log_message($message, $logfile); 

Siehe /system/functions.php.