contao / docs Goto Github PK

• hooks
• DCA callbacks
• content element & front end module controllers

The DCA reference explains how to define an rte for a textarea, typically ace or tinyMCE. We should also document how to customize the editor's configuration (be_tinyMCE.html5 template) and how to create and assign custom configurations (be_tinyCustom.html5 - if this still actually works, I am not sure).

The editor options do not need to be documented, we can link to the documentation of tinyMCE and ACE. Only Contao-specific options should be mentioned.

Das Learn theme hat keinen eigenen print style. Ich würde einen einfachen print style machen wo sidebar, topbar & nav buttons gehidden sind. Plus etwaige Anpassungen (Schriftgröße & Bilder evt.).

Check if we could manage some sort of centralized link collection for external links, so that the can be udpated more easily. See #32 (comment)

Cookbook entry for creating your own table from scratch.

Im Manager gibt es aktuell einen Link zur GitHub bzw. der Doku wie man das Passwort zurücksetzen kann. Gibt es da in der neuen Doku was neues, das wir im Manager einbauen könnten?

As we have additional helper services such as the TokenChecker, I think we should have a chapter about when to use which service to fetch the front end member or back end user, to check if the FE preview is enabled etc.

initialize etc. ...

@netzarbeiter darüber haben wir ja schon mal geredet - also dass es Sinn machen würde eine Art Step-by-Step guide in das Handbuch zu integrieren, wo man durch das Grundsetup von Contao geführt wird, da das bisher eigentlich noch nirgends so erklärt war. Neuankömmlinge in Contao wissen oft nicht, dass zumindest folgende Schritte notwendig sind, um erste Inhalte auf seiner Contao Webseite sehen zu können:

1. Theme anlegen
2. Seitenlayout im Theme anlegen
3. Webseiten Startpunkt anlegen
4. Seitenlayout im Webseiten Startpunkt auswählen
5. Startseite mit Alias index anlegen
6. Startseite mit Inhalt befüllen

Siehe dazu auch contao/contao#601

See #41 & contao/contao#540

Leider funktionieren die prev/next Links nicht richtig: matcornic/hugo-theme-learn#163

e.g.

• https://kubernetes.io/docs/contribute/style/hugo-shortcodes/#tabs
• https://discourse.gohugo.io/t/code-tabs-widget/975/6

(matcornic/hugo-theme-learn#70)

Zusätzliches Environment für die Startseite. Wir könnten da auch einfach das bestehende index.html Template statisch einbinden, denke ich, mit zwei verschiedenen Sprachversionen.

https://community.contao.org/de/showthread.php?74997-Webpack-Encore&p=504390&viewfull=1#post504390

• Methoden erklären
• Customization
• Registrierung von Models

Today I noticed, that for example not all Insert Tag flags that are documented in the old documentation do not exist anymore (see contao/contao#585).

I'll look over it and update everything accordingly (just as I did with hooks and callbacks) :)

Ist die Formatierung bei den Parametern so gewollt oder fehlt mir eine Erweiterung damit das Markdown im Expand greift?

Falls nicht, würde ich das gerne anders formatieren, z.B. als Tabelle.

The caching.md contains something along the lines of

Moreover, you don't have to register to all the different callbacks such as onsubmit_callback or ondelete_callback.
You can simply register to the oninvalidate_cache_tags_callback and add your own tags.

I think it would be great if that was directly cross linked to the respective callbacks once they are documented.

May be use an example where the following tasks are shown:

• adding a field to an existing DCA (includes the PaletteManipulator)
• using a DCA callback
• using a Hook
• using the new field in a template

Though may be that is too much at once.

Die Möglichkeiten des $GOBALS['BE_MOD'] arrays, also was

$GLOBALS['BE_MOD']['...']['...'] = [
    'tables' => ...,
    'table' => ...,
    'list' => ...,
    'option' => ...,
    'callback' => ...,
    ...
];

genau jeweils macht - bzw. alle möglichen Optionen die es gibt (Liste ist vermutlich nicht vollständig).

Apparently there is an inputType called url? Need to confirm this first and then add to the documenation.

Damit meine ich jetzt nicht die Erklärung der Responsive Image Funktion etc. (die gehört natürlich auch in das Handbuch) sondern ich finde man sollte im Handbuch ein wenig auf die unterstützten Image Libraries und deren Unterschiede eingehen. Also GD, Imagick & Gmagick. Unterschiede & Vorteile. Und wie man im Zweifelfall per Konsole überprüfen kann, was nun von Contao tatsächlich automatisch verwendet wird (via debug:container).

Bei der E-Mail Adresse des System Administrators in den System Einstellungen und den Einstellungen des Website Roots kann man auch folgende Notation schreiben:

Max Mustermann <[email protected]>

oder

Max Mustermann [[email protected]]

Contao macht daraus automatisch Name + E-Mail Adresse für den Admin:

https://github.com/contao/contao/blob/f93d72df61bf57316bb9f3555092f9c204007e89/core-bundle/src/Resources/contao/controllers/FrontendIndex.php#L228-L236

Und das wird dann auch so im Formulargenerator für den Absender benutzt:

https://github.com/contao/contao/blob/f93d72df61bf57316bb9f3555092f9c204007e89/core-bundle/src/Resources/contao/forms/Form.php#L373-L375

Ich glaube das war bisher noch nirgends dokumentiert.