320NN Development Wiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== MODX ======

===== Tutorials =====
  * [[babel|Mehrsprachigkeit mit Babel]]
  * [[contentblocks|Erste Schritte mit Contentblocks]]
  * [[rss-feed|RSS-Feed]]
  * [[modx:breitbanddoku|Dokumentation Breitband NRW]]
  * [[modx:bootstrapmenu1|Bootstrap Menü mit Headlines]]
  * [[http://ashleydw.github.io/lightbox/|Lightbox für Modx und Bootstrap]]
  * [[https://forums.modx.com/thread/80377/give-modx-some-speed|Modx Beschleunigen]]
  * [[https://forums.modx.com/thread/88133/simplesearch-how-can-i-change-default-lexicon|SimpleSearch Mehrsprachigkeits Lösungsansatz]]
  * MIGX - Eine funktionierende umgesetzte Anleitung: [[https://www.inside-creative.com/research-and-development/2018/09/26/how-to-setup-and-use-migx-tv-for-modx/|MIGX Anleitung ]]
  * MIGX - Anleitung für verschachtelte MIGX Variablen: [[https://www.codeblick.de/blog/anleitung-modx-veschachteln-von-migx-template-variablen/|Verschachtelte MIGX Template Variablen (einfach) ]]
  * QUIP [[http://onsitenow.co.uk/modx/using-quip-with-modx/index.html|QUIP Kurzanleitung von Mike Nuttall]]


===== Installation =====

==== Manager "leer" nach Installation ====

{{ :modx:modx_manager_empty.png?direct&200|}}

Wenn nach der Installation der Manager "leer" ist, im Sinne von: der Seiten-Baum fehlt, Menü-Punkte funktionieren nicht, Unterseiten lassen sich nicht aufrufen und bleiben "leer", dann liegt dies wahrscheinlich an einem Problem mit den Einstellungen von ''compress_css'' und ''compress_js'', z.B. das die Komprimierung für CSS und JavaScript nicht funktioniert aber aktiviert ist.

Mit [[phpmyadmin:start|phpMyAdmin]] (oder einem anderen Programm) in der Tabelle ''modx_system_settings'' nach den Einträgen ''compress_css'' und ''compress_js'' suchen und dort jeweils das Feld ''value'' von ''1'' auf ''0'' setzen.

Danach **alle** Dateien im Verzeichnis ''/core/cache'' löschen.

{{ :modx:modx_manager.png?direct&200|}}

Nun sollte der MODX-Manager wieder vollständig angezeigt werden und funktionieren.

Quelle: [[http://forums.modx.com/thread/95910/empty-manager-no-file-element-tree-menus-not-working-on-new-install|MODX Forums: Empty manager (no file/element tree, menus not working) on new install]]

====== Standard-Pakete ======

Standard-Pakete, die ich eigentlich auf meinen Installationen fast immer installiere:

  * getResourceField
  * getResources
  * Wayfinder
  * [[https://modx.com/extras/package/seotab|Seo Tab]] [[https://forums.modx.com/thread/88182/how-does-sterc-seo-tab-works-rtfm?page=2|Hilfe im Forum]]
  * ACE - Hilft mit Zeilennummerierung, Formatierung & Suchfunktion beim Editieren von Chunks
  * [[articles|Pressemitteilungen o.ä. mit Articles]]
  * pThumb
  * resizer
  * [[simplesearch|SimpleSearch Tipps]]
  * TinyMCE Rich Text Editor
  * Gallery
  * [[formit|FormIt Package ]]
  * pubwarner (von bytethinker)
  * [[https://modx.com/extras/package/backupmodx|Backup Modx]] - noch nicht getestet
  * [[pdotools|pdoTools]]
  * [[babel|Babel]]

====== Standard-Einstellungen ======

=== Seiten-Name ===

''site_name'' von "MODX Revolution" in den Namen der Website ändern.

=== Seiten-Tagline ===

Wenn die Seite eine Tagline oder Motto hat, dann kann dazu im Kontext eine neue Eigenschaft wie ''site_tagline'' angelegt werden.

=== Seiten-URL ===

Ggf. im Kontext der Website: ''site_url'' für die richtige Adresse im ''BASE''-Tag.

=== Fehler-Seite ===

Die Fehler Seite kann bei ''error_page'' festgelegt werden.

=== Veröffentlicht und Menü ===

Auch diese beiden Einstellungen ''im Menü anzeigen'' und ''veröffentlicht'' lassen sich für die Website einstellen.

===== Update =====

[[http://rtfm.modx.com/revolution/2.x/administering-your-site/upgrading-modx|MODX RTFM: Upgrading MODX]]

[[modx:update|Update]]
==== Update-Script ====

Eine gute Alternative ist das Update-Script von //sottwell//: https://github.com/sottwell/installer

  - Die ''install.php'' ins Hauptverzeichnis der Website legen
  - Plugins- und Erweiterungen im Manager deaktivieren (nicht zwingend nötig, aber sicherer)
  - Cache leeren
  - Ausloggen
  - Im Browser die ''install.php'' aufrufen: http://example.com/install.php

**Achtung**: Immer nur von einer Version zur nächsten aktualisieren, z.B. von 2.4.3 auf 2.4.4 und danach erst auf 2.5.0.

===== Umzug =====

[[umzug|MODX auf einen anderen Server umziehen]]

===== Templates =====

==== Einstellungen ====

=== Icon ===

Unter dem Punkt "Icon" kann ein Icon aus dem Katalog von [[https://fortawesome.github.io/Font-Awesome/|Font Awesome]] ausgewählt werden, dazu muss einfach in dem Feld der Name des Icons, z.B. ''icon-group'', eingegeben werden: [[http://fortawesome.github.io/Font-Awesome/3.2.1/icons/|Icons in Font Awesome 3.2.1]]

Quelle: [[http://forums.modx.com/thread/94728/what-is-the-new-field-icon-for-templates-setup#dis-post-519001|MODX Forums: What is the new field "icon" for template setup?]]

==== Template Tags ====

  * [[http://rtfm.modx.com/revolution/2.x/making-sites-with-modx/tag-syntax|MODX RTFM: Tag Syntax]]
  * [[http://rtfm.modx.com/revolution/2.x/making-sites-with-modx/customizing-content/input-and-output-filters-%28output-modifiers%29|MODX RTFM: Input And Output Filter]]

=== Kommentare ===

<code modx>
[[- Das ist ein Kommentar in der MODX-Template-Syntax ]]
</code>

=== Datum formatieren ===

In getResources:

<code modx>
[[+publishedon:strtotime:date=`%Y-%m-%d`]]
</code>

In pdoResources

<code modx>
[[+publishedon:date=`%Y-%m-%d`]]
</code>

=== URL der aktuellen Seite ===

<code modx>
[[~[[*id]]? &scheme=`full`]]
</code>

=== TV in Kleinbuchstaben und ohne Leerzeichen ===

<code modx>
[[+p0301Headline:strtolower:stripString=` `]]
</code>
===== Chunks =====

[[http://rtfm.modx.com/revolution/2.x/making-sites-with-modx/structuring-your-site/chunks|MODX RTFM: Chunks]]

===== Packages =====

==== Wayfinder ====

  * [[http://sottwell.com/pdf.html?file=assets%2Ffiles%2FWayfinder%20Cheatsheet.pdf|Wayfinder Cheat Sheet für Evolution]] - trotzdem nützlich
  * [[http://sottwell.com/pdf.html?file=assets%2Ffiles%2FUsing%20Wayfinder.pdf|Wayfinder eBook 2009]]
===== Snippets ====

==== ID der Großeltern-Ressource ====

Um die ID der Großeltern-Ressource, also der Eltern-Ressource der Eltern-Ressource, zu bekommen, ist folgendes Snippet hilfreich:

<code php>
<?php
$id = $modx->resource->get('id');
$parents = $modx->getParentIds($id, 2);
$grandparent = $parents[1];
return $grandparent; 
</code>

Wenn das Snippet als ''grandparent'' abgespeichert wird, kann es einfach wie folgt aufgerufen werden:

<code>
[[grandparent]]
</code>

Quelle: [[http://www.sepiariver.ca/blog/modx-web/modx-quick-tip-get-id-of-grandparent/|Sepia River Blog: MODX Quick Tip: Get ID Of Grandparent]]

==== Datum lokalisieren ====

Um ein Datum zu lokalisieren, kann am besten ein eigener Output-Modifier erstellt werden. Dazu muss ein neues Snippet mit dem Namen ''dateLocale'' und folgendem PHP-Schnippsel angelegt werden:

<code php>
<?php
setlocale(LC_ALL, 'de_DE');
 
return strftime($options, $input);
</code>

Der Output-Modifier kann nun wie folgt aufgerufen werden:

<code modx>
[[+publishedon:strtotime:dateLocale=`%e. %B %Y`]]
</code>

Quelle: [[http://forums.modx.com/thread/82522/how-to-set-a-specific-locale-for-the-date-output-filter#dis-post-506866|MODX Forums: How to set a specific locale for the :date output filter?]]

==== Arnes Snippets ====

  * [[https://gist.github.com/akamola/a2c7bbe8de757a2b3421|dateLocal]]
  * [[https://gist.github.com/akamola/27ed4bd3919bb723931d|grandparent]]

===== Sicherheit/Rechte =====

  * [[https://www.youtube.com/watch?v=PKdBvhmZtIw|YouTube: MODX: ACL: Customize the manager using Access Controls, User Groups and Roles]]
  * [[http://bmv-interactive.com/home/modx-acl-tutorial.html|BMV-Interactive: MODX: ACL Security Tutorial]]



===== Mehrsprachigkeit =====

Mehrsprachige MODX-Websites am besten mit [[babel|Babel]].

==== Jumper-Link ====

<code php>
<p id="jumper"><a href="#content">[ [[++cultureKey:is=`de`:then=`Direkt zum Inhalt`:else=`[[++cultureKey:is=`nl`:then=`Direct naar de inhoud`:else=`Jump to content`]]`]] ]</a></p>
</code>

===== Erweiterungen =====

  * [[http://rtfm.modx.com/extras/revo/getresources|getResources]]
    * [[getresources|Weiteres zu getResources]]
  * [[http://rtfm.modx.com/extras/revo/wayfinder|Wayfinder]]
  * [[http://www.belafontecode.com/image-manipulation-with-phpthumbof-in-modx-revolution/|pthump oder phpthumb]]
==== Weitere Erweiterungen ====

  * [[http://rtfm.modx.com/extras/revo/articles|Articles]]

==== Kommerzielle Erweiterungen ====

  * [[https://www.modmore.com/|modmore]]
    * [[https://www.modmore.com/extras/moregallery/|MoreGallery]] 
    * [[https://www.modmore.com/extras/redactor/|Redactor]]
    * [[https://www.modmore.com/extras/simpleab/|SimpleAB]]

===== Links =====

  * [[http://modx.com/|MODX]]
  * [[https://pinboard.in/u:aberaberarne/t:modx|Arnes Link-Sammlung zu MODX]]

===== Tipps & Tricks =====

==== Tiny-MCE Überflüssiges p-Tag ====

In den Einstellungen (Custom Parameters) des Plugins Tiny MCE //forced_root_block:false// eintragen behebt das Problem.

[[http://de.modx.com/forum/thread/2033/geloest-tinymce-fuegt-p-tags-ein-wo-er-nicht-soll|Quelle: Modx-Forum ]]

==== Dynamischer Chunk-Aufruf ====

Der gewöhnliche Chunk-Aufruf sieht so aus:

<code HTML>[[$meinchunk?]]</code>

In dem Chunk $meinchunk soll zum Beispiel stehen:

<code HTML>
<h1>Hier soll spezieller Text hin</h1>
</code>

Diesen kann man nun dem Chunk-Aufruf mitgeben. Und zwar so:

<code HTML>[[$meinchunk? &meintext=`Hallo! Das klappt ja super!`]]</code>

Im Chunk schreibt man:

<code HTML>
<h1>[[+meintext]]</h1>
</code>

Ergebnis:

<h1>Hallo! Das klappt ja super!</h1>

=== MIGX TV empty/notempty ===

Mit dieser Konstruktion kann man auch Migx Variablen auf leer prüfen. Hinweis: Das funktioniert gut für Seiten, für Übersichtsseiten oder Teaser ist das keine gute Konstruktion, da es Probleme mit dem Cache und den Placeholdern gibt. (Auch wenn man diese durchnummeriert)

<code HTML>
[[getImageList?
 &tvname=`content-image`
 &docid=`[[+id]]`
 &tpl=`news-teaser-FirstRowTpl-image`
 &toPlaceholder=`migx_output`
]] 

[[+migx_output:notempty=`[[+migx_output]]`:default=`
 <p>Leider kein Glück!</p>
`]]
</code>

=== IF / ELSE MIT PDO Field ===

<code HTML>
[[pdoField:isequalto=`1`:then=`<p>Ist 1</p>`:else=`<p>Ist null</p>`? &id=`2393` &field=`showelement-headersponsor` ]]
</code>
==== Template Variablen unter dem Content-Feld ====

In den System-Einstellungen "tvs_below_content" auf ja setzen

==== Seitenbaum mit Menütiteln ====

[[https://docs.modx.com/revolution/2.x/administering-your-site/settings/system-settings/resource_tree_node_name||Baum mit Menütitel]]

In den System-Einstellungen "resource_tree_node_name" auf "menutitle" setzen. Es gibt ein Fallback für Seiten, die keinen "menutitle" haben.

==== QUIP ====

Quip ist nach dem neuesten Stand nicht DSGVO-kompatibel. Denn es speichert IP-Adressen. Das ist nicht mehr erlaubt.

Dazu folgende Anleitung:

Patch core/components/quip/processors/web/comment/create.php and comment line 118

<code PHP>$comment->set('ip',$_SERVER['REMOTE_ADDR']);</code>

[[https://forums.modx.com/thread/103923/quip-anonymize-ip-in-comments---dsgvo|QUIP DSGVO IP Adressen speichern abstellen im MODX Forum]]

==== Englischer Monat - Datumsformat ====

Wenn zum Beispiel mit Quip immer der falsche Monat im Kommentartemplate ausgegeben wird, dann kann die Variable 'locale' in den Systemeinstellungen geändert werden. Ich habe diesen Wert eingetragen

<code PHP>de_DE.UTF8</code>

Hat geholfen