Update eigene-felder-hinzufuegen.md

[Aybee]

Ergänzt

[aschempp]

Der entsprechende Code ist aus meiner Sicht nicht nötig, das highlighting funktioniert problemlos: https://docs.contao.org/books/manual/3.2/de/07-contao-anpassen/eigene-felder-hinzufuegen.html

Ausserdem ist das Handbuch für Version 3.2 nicht mehr gepflegt, und in den neueren Versionen konnte ich den entsprechenden Bereich nicht finden?

[Aybee]

Ja, jetzt so im Nachhinein sehe ich, dass überall darauf verzichtet wird. Es ist also davon auszugehen, dass PHP-Code innerhalb von <?php stehen muss. Sehe ich eigentlich auch so. War nur ne Fehlermeldung aus dem Forum, wo man dies nicht wusste.

und in den neueren Versionen konnte ich den entsprechenden Bereich nicht finden?

Ja, geht mir auch so. Ich habe da überhaupt keinen Plan, wie man was finden soll. Es gibt zu viele Manuals und man weiß nicht, was wo drin steht.

User Manual
  Contao 4.4
    EN
    DE
    FR
  Contao 3.5 LTS
    EN
    DE
    FR
  Contao Manager
    EN
    DE
  Outdated versions
    Contao 4.3
      EN
      DE
      FR
    Contao 4.2
      EN
      DE
      FR
    Contao 4.0
      EN
      DE
      FR
    Contao 3.4
      EN
      DE
      FR
    Contao 3.3
      EN
      DE
      FR
    Contao 3.2 LTS
      EN
      DE
      FR
    Contao 3.1
      EN
      DE
    Contao 3.0
      EN
      DE
    Contao 2.11
      EN
      DE
Developer Documentation
  Cookbook
    EN
  API Reference
    EN
  Extending Contao 4
    EN
  Manager API
    EN

Hat man sich für eins entschieden kommt noch die Abfrage der Sprache und man weiß nicht, welche man wählen soll, weil es manche Infos nur ich bestimmten Sprachen gibt bzw. unterschiedliche Artikel vorhanden sind.

Man kann in den Docs auch nicht auf eine andere Sprache switchen, weil die wahrscheinlich irgendwie nicht miteinander verbunden sind, oder warum auch immer.

Im Endeffekt versucht man über Google an die Infos ranzukommen, landet dabei aber natürlich auch in der z.B. 3.2 Doku und weiß nicht, wie man jetzt von da aus auf eine aktuellere Version kommen soll.

Teillösung für diese Probleme wäre z.B. die Docs auf Englisch zu pflegen und eine Übersetzungsmöglichkeit anzubieten, gibt es für einen Artikel keine Übersetzung, dann wird der englische als Fallback angezeigt. So wie das auch auf php.net oder developer.mozilla.org gehandhabt wird. Um die Gültigkeit der Info herauszufinden müssten diese mit Versionen getagt werden, auch so wie auf php.net oder developer.mozilla.org.

Die entsprechende neuere Doku, welche du nicht gefunden hast müsste diese hier sein https://docs.contao.org/books/cookbook/customizing-contao/adding-custom-fields.html

[Aybee]

highlighting funktioniert problemlos

Verstehe ich nicht, was du damit meinst.

[aschempp]

Es gibt zu viele Manuals und man weiß nicht, was wo drin steht.

Es gibt genau zwei Manuals, für jede aktiv gepflegte Version von Contao. Das ist unter https://docs.contao.org zu sehen. Alle anderen Handbücher sind nicht mehr aktuell und werden auch nicht mehr gepflegt.

Hat man sich für eins entschieden kommt noch die Abfrage der Sprache und man weiß nicht, welche man wählen soll, weil es manche Infos nur ich bestimmten Sprachen gibt bzw. unterschiedliche Artikel vorhanden sind.

Die Sprachen der Handbücher sind alle identisch, da gibt es keine unterschiedlichen Artikel.

[…] z.B. 3.2 Doku und weiß nicht, wie man jetzt von da aus auf eine aktuellere Version kommen soll.

Dafür gibt es links oben in jedem Handbuch eine Versions-Auswahl.

Die entsprechende neuere Doku, welche du nicht gefunden hast müsste diese hier sein

Korrekt. Wir haben die technischen Informationen aus dem Manual entfernt und in's Cookbook verschoben. Seither ist es auch nur noch auf Englisch verfügbar, was aus meiner Sicht für Entwickler reichen sollte.

[Aybee]

Ich sag ja, ich habe da keinen Plan und fühle mich dort meistens einfach nur verloren, vor allem, wenn man über die Google-Suche auf so ne Seite kommt. Wenn ich hiernach suche contao eigene felder hinzufügen site:docs.contao.org finde ich z.B. keinen Link nach 3.5 und auch nicht ins Cookbook. Aber ist mir klar, dass man da jetzt auch nichts dran ändern kann.

Ja, nur Englisch ist in Ordnung. Man kann ja ne Übersetzungsmöglichkeit anbieten wie bei oben genannten Beispieldomains.