Merge pull request #146 from dragomano/docs

Update docs

Author: dragomano

.github/workflows/deploy.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v3
         with:
-          node-version: '16'
+          node-version: '20'
 
       - name: Get yarn cache
         id: yarn-cache

website/i18n/de/docusaurus-plugin-content-docs/current/getting-started/configuration.md

@@ -53,7 +53,6 @@ In diesem Abschnitt können Sie die allgemeinen Einstellungen von Seiten und Bl
 * Links zu den vorherigen und nächsten Seiten anzeigen – aktivieren Sie dies, falls Sie Links auf Seiten sehen möchten, die vor und nach der aktuellen Seite erzeugt wurden.
 * Verwandte Seiten anzeigen – falls es Seiten gibt, die einer Seite ähnlich sind (bezüglich Titel und Alias), werden Sie unten auf der Seite angezeigt.
 * Seitenkommentare zeigen – für Benutzergruppen mit der Berechtigung, Seiten zu kommentieren, wird am Seitenende ein Kommentarformular angezeigt.
-* In Kommentaren erlaubter BBCode – Sie können Tags angeben, die beim Kommentieren von Seiten verwendet werden dürfen.
 * Maximale Zeit nach dem Kommentieren, in der Änderungen vorgenommen werden können - nach der angegebenen Zeit (nach dem Erzeugen eines Kommentars) werden Sie Ihre Kommentare nicht mehr anpassen können.
 * Anzahl der direkten Kommentare pro Seite – geben Sie die maximale Anzahl von Kommentaren an, die keine Antworten auf andere Kommentare sind, die auf einer einzelnen Seite angezeigt werden sollen.
 * Sortiere Kommentare standardmäßig — wählen Sie das gewünschte Sortierverfahren für Kommentare auf Portalseiten aus.

website/i18n/de/docusaurus-plugin-content-docs/current/getting-started/updating.md

@@ -3,6 +3,7 @@ sidebar_position: 2
 ---
 
 # Version aktualisieren
+
 Falls im Änderungsprotokoll der neuesten Version keine weiteren Hinweise enthalten sind, reicht es aus, die Verzeichnisse `Themes` und `Sources` aus dem Modifikations-Archiv in das Wurzelverzeichnis Ihres Forums zu entpacken, dabei existierende Dateien zu überschreiben, und das Update ist erledigt. Allerdings ist es am besten, die aktuelle Version zu deinstallieren bevor Sie die neue Version installieren.
 
 :::info
@@ -12,8 +13,3 @@ Seit Version 2.2.1 können Sie upgraden ohne die vorherige Version zu deinstalli
 ![Aktualisieren](upgrade.png)
 
 :::
-
-## Problembehebung
-
-### Warning: Undefined array key "bla-bla-bla"
-Falls Sie nach dem Update einen vergleichbaren Fehler im Portalblock sehen, versuchen Sie die Einstellungen des Blocks aufzurufen und Sie erneut zu speichern. Dies ist kein Fehler, sondern eine Warnung über fehlende (neue) Blockeinstellungen in der Datenbank.

website/i18n/de/docusaurus-plugin-content-docs/current/intro.md

@@ -5,6 +5,12 @@ slug: /
 
 # Einführung
 
-Willkommen zum Light-Portal-Schnellstart!
+Welcome to the Light Portal Quick Start!
 
 > Light Portal ist eine Modifikation, die Ihr [SMF](https://www.simplemachines.org)-basiertes Forum in ein einfaches und praktisches Portal mit Blöcken und Seiten verwandelt.
+
+---
+
+I want to make sure you’re getting the most out of LP and that no questions go unanswered.
+
+If you have any questions or general thoughts, leave them in [the support topic](https://www.simplemachines.org/community/index.php?topic=572393.0) or [GitHub Discussions](https://github.com/dragomano/Light-Portal/discussions) and I’ll get back to you ASAP.

website/i18n/de/docusaurus-plugin-content-docs/current/plugins/all-hooks.md

@@ -3,167 +3,239 @@ sidebar_position: 4
 ---
 
 # Portal-Hooks
+
 Dank Plugins ist Light Portal wundervoll erweiterbar. Hooks helfen Plugins, mit verschiedenen Komponenten des Portals zu interagieren.
 
 ## Grundlegende Hooks
 
 ### init
+
 > $txt-Variablen überschreiben, SMF-Hooks ausführen, etc.
 
 ### prepareEditor
+
 (`$context['lp_block']` for block, `$context['lp_page']` for page)
+
 > Beliebigen Code zum Block-/Seite-Bearbeiten-Bereich hinzufügen
 
 ### parseContent
+
 (`&$content, $type`)
+
 > Den Inhalt von benutzerdefinierten Block-/Seitentypen parsen
 
 ### prepareContent
+
 (`$data, $parameters`)
+
 > Den benutzerdefinierten Inhalt Ihres Plugins hinzufügen
 
 ### credits
+
 (`&$links`)
+
 > Lizenzen der verwendeten Bibliotheken/Scripts etc. hinzufügen
 
 ### addAdminAreas
+
 (`&$admin_areas`)
+
 > Benutzerdefinierte Bereiche zu SMFs „integrate_admin_areas“-Hook hinzufügen
 
 ## Mit Blöcken arbeiten
 
 ### blockOptions
+
 (`&$options`)
+
 > Benutzerdefinierte Blockparameter hinzufügen
 
 ### prepareBlockFields
+
 > Benutzerdefinierte Felder zum Block-Erstellungsbereich hinzufügen
 
 ### validateBlockData
+
 (`&$parameters, $context['current_block']['type']`)
+
 > Benutzerdefinierte Verifizierungsregeln für das Hinzufügen/Bearbeiten von Blöcken hinzufügen
 
 ### findBlockErrors
+
 (`&$post_errors, $data`)
+
 > Benutzerdefinierte Fehlerbehandlung für das Hinzufügen/Bearbeiten von Blöcken hinzufügen
 
 ### onBlockSaving
+
 (`$item`)
+
 > Benutzerdefinierte Aktionen beim Speichern/Bearbeiten von Blöcken
 
 ### onBlockRemoving
+
 (`$items`)
+
 > Benutzerdefinierte Aktionen beim Löschen von Blöcken
 
 ## Mit Seiten arbeiten
 
 ### pageOptions
+
 (`&$options`)
+
 > Benutzerdefinierte Seitenparameter hinzufügen
 
 ### preparePageFields
+
 > Benutzerdefinierte Felder zum Seiten-Erstellungsbereich hinzufügen
 
 ### validatePageData
+
 (`&$parameters`)
+
 > Benutzerdefinierte Verifizierungsregeln für das Hinzufügen/Bearbeiten von Seiten hinzufügen
 
 ### findPageErrors
+
 (`&$post_errors, $data`)
+
 > Benutzerdefinierte Fehlerbehandlung für das Hinzufügen/Bearbeiten von Seiten hinzufügen
 
 ### onPageSaving
+
 (`$item`)
+
 > Benutzerdefinierte Aktionen beim Speichern/Bearbeiten von Seiten
 
 ### onPageRemoving
+
 (`$items`)
+
 > Benutzerdefinierte Aktionen beim Löschen von Seiten
 
 ### preparePageData
+
 (`&$data`, `$is_author`)
+
 > Benutzerdefinierte Vorbereitung der Daten der aktuellen Seite des Portals
 
 ### beforePageContent
+
 > Bietet die Möglichkeit, etwas vor dem Inhalt der Portalseite anzuzeigen
 
 ### afterPageContent
+
 > Bietet die Möglichkeit, etwas nach dem Inhalt der Portalseite anzuzeigen
 
 ### comments
+
 > Benutzerdefiniertes Kommentar-Script zur aktuellen Portalseitenansicht hinzufügen
 
 ### commentButtons
-(`$comment`)
+
+(`$comment`, `&$buttons`)
+
 > Benutzerdefinierte Schaltflächen unter jedem Kommentar hinzufügen
 
 ## Mit Plugins arbeiten
 
 ### addSettings
+
 (`&$config_vars`)
+
 > Benutzerdefinierte Einstellungen zu Ihrem Plugin hinzufügen
 
 ### saveSettings
+
 (`&$plugin_options`)
+
 > Zusätzliche Aktionen nach dem Speichern von Plugin-Einstellungen
 
 ## Portaleinstellungen
 
 ### addBlockAreas
+
 (`&$subActions`)
+
 > Benutzerdefinierte Reiter in den Block-Einstellungen hinzufügen
 
 ### addPageAreas
+
 (`&$subActions`)
+
 > Benutzerdefinierte Reiter in den Seiten-Einstellungen hinzufügen
 
 ## Mit Artikeln arbeiten
 
 ### frontModes
+
 (`&$this->modes`)
+
 > Benutzerdefinierte Modi für die Hauptseite hinzufügen
 
 ### frontCustomTemplate
+
 (`$layouts`)
+
 > Benutzerdefinierte Vorlagen für die Hauptseite hinzufügen
 
 ### frontAssets
+
 > Benutzerdefinierte Scripts und Stile zur Hauptseite hinzufügen
 
 ### frontTopics
+
 (`&$this->columns, &$this->tables, &$this->wheres, &$this->params, &$this->orders`)
+
 > Benutzerdefinierte Spalten, Tabellen, WHEREs, Parameter und Sortierung zur _init_-Funktion hinzufügen
 
 ### frontTopicsOutput
+
 (`&$topics, $row`)
+
 > Verschiedene Manipulationen der Query-Ergebnisse der _getData_-Funktion
 
 ### frontPages
+
 (`&$this->columns, &$this->tables, &$this->wheres, &$this->params, &$this->orders`)
+
 > Benutzerdefinierte Spalten, Tabellen, WHEREs, Parameter und Sortierung zur _init_-Funktion hinzufügen
 
 ### frontPagesOutput
+
 (`&$pages, $row`)
+
 > Verschiedene Manipulationen der Query-Ergebnisse der _getData_-Funktion
 
 ### frontBoards
+
 (`&$this->columns, &$this->tables, &$this->wheres, &$this->params, &$this->orders`)
+
 > Benutzerdefinierte Spalten, Tabellen, WHEREs, Parameter und Sortierung zur _init_-Funktion hinzufügen
 
 ### frontBoardsOutput
+
 (`&$boards, $row`)
+
 > Verschiedene Manipulationen der Query-Ergebnisse der _getData_-Funktion
 
 ## Mit Symbolen arbeiten
 
 ### prepareIconList
+
 (`&$all_icons, &$template`)
+
 > Benutzerdefinierte Symbole (statt FontAwesome) hinzufügen
 
 ### prepareIconTemplate
+
 (`&$template, $icon`)
+
 > Benutzerdefinierte Vorlage zum Anzeigen von Symbolen hinzufügen
 
 ### changeIconSet
+
 (`&$set`)
+
 > Bietet die Möglichkeit, Interface-Symbole, die über das `$this->context['lp_icon_set']`-Array verfügbar sind, zu erweitern

website/i18n/de/docusaurus-plugin-content-docs/current/plugins/create-new.md

@@ -3,6 +3,7 @@ sidebar_position: 2
 ---
 
 # Plugin hinzufügen
+
 Plugins sind die Erweiterungen, die die Fähigkeiten von Light Portal erweitern. Um Ihr eigenes Plugin zu erzeugen, folgen Sie einfach den Anweisungen unterhalb.
 
 :::info
@@ -12,22 +13,59 @@ Sie können **PluginMaker** bei der Erstellung Ihrer eigenen Plugins zu Hilfe ne
 :::
 
 ## Wählen Sie die Art von Plugin
+
 Aktuell sind die folgenden Arten von Plugins verfügbar:
 
-* `block` — Plugins, die einen neuen Blocktyp für das Portal hinzufügen
-* `ssi` — Plugins (normalerweise Blöcke), die SSI-Funktionen verwenden, um Daten abzurufen
-* `editor` — Plugins, die einen Drittanbieter-Editor für verschiedene Arten von Inhalten hinzufügen
-* `comment` — Plugins, die ein Drittanbieter-Kommentar-Widget hinzufügen
-* `parser` — Plugins, die einen Parser für den Inhalt von Seiten und Blöcken implementieren
-* `article` — Plugins, um den Inhalt von Artikelkarten auf der Hauptseite zu verarbeiten
-* `frontpage` — Plugins, die die Hauptseite des Portals ändern
-* `impex` — Plugins zum Importieren und Exportieren diverser Portalelemente
-* `block_options` und `page_options` — Plugins, die weitere Parameter für das entsprechende Element (Block oder Seite) hinzufügen
-* `icons` — Plugins, die neue Symbolbibliotheken hinzufügen, um Interface-Elemente zu ersetzen oder sie in Blocküberschriften zu verwenden
-* `seo` — Plugins, die in irgendeiner Weise die Sichtbarkeit des Forums im Netzwerk beeinflussen
-* `other` — Plugins, die in keine der obigen Kategorien fallen
+### `Block`
+
+Plugins that add a new type of blocks for the portal.
+
+### `ssi`
+
+Plugins (usually blocks) that use SSI functions to retrieve data.
+
+### `editor`
+
+Plugins that add a third-party editor for different types of content.
+
+### `comment`
+
+Plugins that add a third-party comment widget instead of the built-in.
+
+### `parser`
+
+Plugins that implement the parser for the content of pages and blocks.
+
+### `article`
+
+Plugins for processing the content of article cards on the main page.
+
+### `frontpage`
+
+Plugins for changing the main page of the portal.
+
+### `impex`
+
+Plugins for importing and exporting various portal elements.
+
+### `block_options` | `page_options`
+
+Plugins that add additional parameters for the corresponding entity (block or .page).
+
+### `icons`
+
+Plugins that add new icon libraries to replace interface elements or for use in block headers
+
+### `seo`
+
+Plugins that somehow affect the visibility of the forum on the network.
+
+### `other`
+
+Plugins that are not related to any of the categories above.
 
 ## Ein Plugin-Verzeichnis erzeugen
+
 Erzeugen Sie ein separates Verzeichnis für Ihre Plugin-Dateien, innerhalb von `/Sources/LightPortal/Addons`. Falls Ihr Plugin zum Beispiel `HelloWorld` heißt, sollte die Verzeichnisstruktur wie folgt aussehen:
 
 ```
@@ -75,14 +113,16 @@ class HelloWorld extends Plugin
 ```
 
 ## Verwendung von SSI
+
 Falls das Plugin Daten über SSI-Funktionen abrufen muss, verwenden Sie die eingebaute `getFromSsi(string $function, ...$params)`-Methode. Als Parameter `$function` müssen Sie den Namen einer der Funktionen übergeben, die in der Datei **SSI.php** enthalten sind, ohne Präfix `ssi_`. Zum Beispiel:
 
 ```php
 <?php
 
-    // See ssi_topTopics function in the SSI.php file
-    $data = $this->getFromSsi('topTopics', 'views', 10, 'array');
+// See ssi_topTopics function in the SSI.php file
+$data = $this->getFromSsi('topTopics', 'views', 10, 'array');
 ```
 
 ## Verwendung von Composer
+
 Ihr Plugin kann Drittanbieter-Bibliotheken verwenden, die mit Composer installiert wurden. Stellen Sie sicher, dass die Datei `composer.json`, die die notwendigen Abhängigkeiten enthält, im Plugins-Verzeichnis liegt. Bevor Sie Ihr Plugin veröffentlichen, öffnen Sie das Plugin-Verzeichnis auf der Kommandozeile und führen diesen Befehl aus: `composer install --no-dev -o`. Anschließend kann der gesamte Inhalt des Plugin-Verzeichnisses als separate SMF-Modifikation verpackt werden (sehen Sie sich zum Beispiel das **PluginMaker**-Paket an).

website/i18n/el/docusaurus-plugin-content-docs/current/getting-started/configuration.md

@@ -53,7 +53,6 @@ sidebar_position: 3
 * Εμφάνιση συνδέσμων προς τις προηγούμενες και τις επόμενες σελίδες — ενεργοποιήστε το εάν θέλετε να δείτε συνδέσμους σε σελίδες που δημιουργήθηκαν πριν και μετά την τρέχουσα σελίδα.
 * Εμφάνιση σχετικών σελίδων — εάν μια σελίδα έχει παρόμοιες σελίδες (κατά τίτλο και ψευδώνυμο), αυτές θα εμφανίζονται στο κάτω μέρος της σελίδας.
 * Εμφάνιση σχολίων σελίδας — εάν επιτρέπεται να σχολιάσετε μια σελίδα, μια φόρμα σχολίων θα εμφανιστεί στο κάτω μέρος της σελίδας.
-* Επιτρέπεται το BBCode στα σχόλια — μπορείτε να καθορίσετε ετικέτες που επιτρέπεται να χρησιμοποιούνται όταν σχολιάζετε σελίδες.
 * Μέγιστος χρόνος μετά το σχόλιο για να επιτρέπεται η επεξεργασία — μετά την καθορισμένη ώρα (μετά τη δημιουργία σχολίου), δεν θα μπορείτε να αλλάξετε σχόλια.
 * Αριθμός γονικών σχολίων ανά σελίδα — καθορίστε τον μέγιστο αριθμό σχολίων που δεν είναι υποσχόλια να θα εμφανίζονται σε μία σελίδα.
 * Ταξινόμηση σχολίων από προεπιλογή — επιλέξτε τον επιθυμητό τύπο ταξινόμησης για σχόλια σε σελίδες πύλης.