Hole und Nutze APIs – JSON Content Importer

Änderungsprotokoll

= 1.5.4=
* Plugin ok with WordPress 6.4.1
* Improved Security in the Backend

= 1.5.3=
* Erweiterung, siehe Tab „Grundeinstellungen“: Übertrage Header „HEADER_KEY:HEADER_VALUE“: Füge dazu ‚header HEADER_KEY1:HEADER_VALUE1#HEADER_KEY2:HEADER_VALUE2‘ im folgenden Feld ein, wobei ‚Bearer‘ wird nicht hinzugefügt. wird. Z. B. ‚header User-Agent:JCIfree‘
* Erweiterung: Die interne Kommunikation eines WordPress Block basiert auf APIs, die typischerweise mit GET-Anfragen gemacht wird. Für größere Datenmengen kommt das an Grenzen, dafür sind POST Anfragen nötig. Diese neue Version von JCI nutzt POST statt GET.
* Änderung: Manche Server haben Probleme, jcifree-block.php als JavaScript-Applicaton (strikte „mime policy“) zu erkennen und verweigern die Programmausführung. Lösung: Umbenennung der Datei in jcifree-block.js
* Einige Korrekturen im Hintergrund für Block-React, PHP8…

1.5.2

• Fehlerkorrektur: der JCI Block wurde nicht zur Auswahl angeboten, wenn beim benutzten Browser die „strict mime type“ Einstellungen aktiv sind. Mit dieser Korrektur ist das kein Problem mehr.

1.5.1

• Behoben: JCI-Block – In einigen Situationen wird unerwünschter Inhalt (‚Willkommenstext‘) auf der veröffentlichten Seite angezeigt.
• Verbessert: Übersetzung

1.5.0

• Versionsprobleme: WordPress.org aktualisiert nicht von 1.4 auf 1.4.1

1.4.1

• Bugfix: Die Standardeinstellungen des Shortcode-Parameters basenode waren falsch. Dies wurde nun korrigiert.

1.4

• Empfehlung: Bitte überprüfen Sie Ihren JCI-Cache! Das Plugin zeigt die Anzahl der Dateien im JCI-Cache und deren Größe an. Mit der Funktion „Cache löschen“ können Sie die zwischengespeicherten Dateien löschen.
• Stark verbesserte Admin-Oberfläche: Tabs, Beispiele, Einstellungen, Schritt 1, Schritt 2,…
• Stark verbesserter JCI-Block. Bessere Fehlerbehandlung und als Highlight die Erstellung von Templates.
• Neu: Verbesserter Deinstallationsprozess.
• Kleinere PHP8 Korrekturen
• Neue Screenshots und verbesserte Plugin-Beschreibung

1.3.17

• WordPress 6.2 hat die Art und Weise geändert, wie Blöcke gerendert werden. Dieses Update behebt den Absturz des JCI-Blocks mit WordPress 6.2

1.3.16

• Behobenes Sicherheitsproblem: Rio D. hat eine Cross Site Scripting (XSS)-Schwachstelle in Patchstack entdeckt und gemeldet. Danke Rio! Zur Nutzung benötigen Sie einen WordPress-Backend-Zugriff und die betroffene Seite befindet sich ausschließlich im WordPress-Adminbereich. Dennoch: Aktualisieren Sie bitte Ihr JCI-Plugin!
• PHP 8.1 Korrekturen

1.3.15

• Neu! Verwenden Sie JCILISTITEM, um eine JSON-Liste anzuzeigen: {subloop-array:mylist:no_first_item,no_last_item}AA{JCILISTITEM}BB<
  {/subloop-array:mylist}, siehe https://doc.json-content- importer.com/json-content-importer/free-show-the-data/ für mehr
• Erweitert! „purejsondata,ifNotEmptyAdd“, „purejsondata,ifNotEmptyAddRight“, „purejsondata,ifNotEmptyAddLeftRight“ und „purejsondata,ifNotEmptyAddLeft“, z. G. {jsondata:purejsondata,ifNotEmptyAddLeft:TEXT}, siehe https://doc.json-content-importer.com/json-content-importer/free-show-the-data/ für mehr
• Plugin Ok für WP 6.1.1
• PHP 8.1 Korrekturen

1.3.14

• Neuer Shortcode-PArameter: „trytorepairjson=16“ im Shortcode entfernt Nicht-ASCII-Zeichen aus den JSON-Daten
• Fehlerkorrektur nötig aufgrund von Ändeurngen bei WordPress 6.0: Der JSONcontentimporter-Quicktag muss etwas anders geladen werden
• Fehlerbehebung: Korrektur eines Fehlers, der autritt wenn in einem JSON-Node ( oder ) enthalten ist
• Plugin funktioniert mit WordPress 6.0.2

1.3.13

• sslverify-Schalter in den optionen hinzugefügt: Falls ein https-Zertifikat plötzlich ungültig ist, schalte dessen Prüfung aus (nicht ideal,aber pragmatisch)
• Mehrere Verbesserungen der Debug-Anzeige (z. B. einschalten des Debugmodus mit debugmode=10 im shortcode)
• Plugin Ok mit WP 5.8.1

1.3.12

• Wichtige Fehlerkorrektur die den JCI-Gutenberg-Block beschleunigt! Falls Du WordPress mit Gutenberg-Blöcken betreibst(also ohne aktives ClassicEditor-Plugin), werden mehrere Software-Bibliotheken unnötigerweise geladen(egal ob ein JCI-Gutenberg-Block gerade genutzt wird oder nicht). Das verzögert die Ladezeit der Website und führt ggf. zu schlechten Ergebnissen z.B. bei Google Pagespeed https://developers.google.com/speed/pagespeed/ ). Mit dieser korrigierten Version ist dieses Problem behoben.
• Hintergrund-Prüfung von allow_url_fopen in den Plugin Optionen: Falls allow_url_fopen nicht auf TRUE in den PHP-Einstellungen gesetzt ist, könnte die verhindern, dass PHP und das Plugin JSON mittels eines http-requests von einem anderen Server holen kann (falls hier kein roter Text zu sehen ist, ist alles ok)
• Plugin Ok mit WP 5.6.1

1.3.11

• Internationalisierung hinzugefügt: Verfügbare Sprachen sind Englisch und Deutsch. Weitere Übersetzungen sind herzlich willkommen!
• Shotcode-Parameter nojsonvalue: Wenn „nojsonvalue=y“ im Shortcode gesetzt ist, ist die API-Answer als Feld {nojsonvalue} im Template verfügbar. Das ist hilfreich, wenn die API nicht JSON liefert.
• Plugin funktioniert mit WordPress 5.6

1.3.10

• Fehlerkorrektur: Falls in einer subloop-Schleife Elemente nicht mit Daten ersetzt wurden kam es bisher zu Fehlern
• Plugin funktioniert mit WordPress 5.5.1

1.3.9

• Fehlerkorrektur: Falls ein JSON-Datenfeld nicht immer oder NULL ist, wurde die Darstellung abgebrochen
• Platzhalter im Template: Wenn Du Klammern wie {}[] im Template benötigst, kann das Probleme mit der WordPress-Shortcode-Syntax oder dem Template-Parser hervorrufen. Damit das nicht passiert, bitte stattder Klammern Platzhalter verwenden: #CBO# (curly brackets open), #CBC# (curly brackets close), #SBO# (square brackets open) und #SBC# (square brackets close) ibitte verwenden statt der Klammern. Die Platzhalter werden durch die eigentlichen Werte durch das Parsen ersetzt.
• Plugin funktioniert mit WordPress 5.4.2

1.3.8

Plugin funktioniert mit PHP 7.4

1.3.7

• Neue Option: Falls eine http-API-Anfrage scheitert, kann ggf. auf zwischengespeichertes JSON aus dem Cache-Speicher zurückgegriffen werden: can Dazu muss der passende Radio-Button in den Plugin-Einstellungen aktiv sein: Wie sollen API-probleme behandelt werden (entweder eine ungültige API-http-Antwort oder kein JSON als API-Antwort – oder beides). Für die Rückwarts-Kompatibilität ist die als Standard ausgeschaltet. Empfehlung: Schalte den Plugin-Cacher (z. B. mit einigen Minuten Cachezeit) an und wähle den Radio-Button „Wenn die API-http-Antwort nicht 200 ODER ungültiges JSON ist: Versuche gecachtes JSON zu verwenden“ in den Plugin-Optionen.

1.3.6

• Fehlerkorrektur: Füge Gutenberg-JavaScript nur im Backend hinzu (davor war es auch öffentlich im Frontend eingebunden)

1.3.5

• Neu: Dem WordPress-Editor wurde ein „Quicktag“ hinzugefügt. Damit kann man den JSONContentImporter-Shortcode inkl. einem Beispiel per Klick schnell hinzufügenkann

1.3.4

• Neue Plugin-Option: Gutenberg ausschalten (ggf. benötigt ein Sitebuilder dies)

1.3.3

• Fehlerkorrektur der Fehlerkorrektur, Entschuldigung…

1.3.2

• Fehlerkorrektur: Erkenne Gutenberg und WordPress 5.0

1.3.1

• Fehler behoben

1.3.0

• Plugin funktioniert mit dem the Gutenberg Plugin 3.9.0
• Gutenberg-Modus: Wenn der Gutenberg-Modus in Deinem WordPress und dem JCI-Plugn aktiv ist, siehst Du ein einfaches Beispiel zum Testen und Kennenlernen der Plugin-Nutzung. Falls Du Gutenberg auf der veröffentlichten WordPress-Website nicht verwenden willst: Dann ist dieser Modus immer noch sehr hilfreich für die Zusammenstellung des Shortcode (Du kannst diesen fast vollständig zusammenklicken)

1.2.20

• Plugin funktioniert mit WordPress 4.9.8
• Plugin funktioniert mit Gutenberg Plugin 3.6.2
• Das Plugin berücksiochtigt die Datenschutzgrundverordnung (DSGVO): Das Plugin selbst sammelt keine personenbezogenen Data. Aber: Falls die verwendete API personenbezogene Daten verarbeitet wird die DSGVO relevant. Ggf. ist dann auch dieses Plugin als Hilfsmittel in Deiner DSGVO-Dokumentation erwähnenswert.
• Verbesserter Debugmodus (füge dafür debugmode=10 im Shortcode hinzu)
• Videolink geändert: Besseres Video mit Anleitungen eingebunden
• Link zum Umstieg auf die PRO-Version des Plugins hinzugefügt.

1.2.19

• Plugin funktioniert mit WordPress 4.91
• Das Hinzufügen von „debugmode=10“ zum Shortcode zeigt Dir Informationen wie der Abruf der API-JSON-Daten und das Konvertieren zu HTML mit dem Template abläuft.
• Das Plugin verwendet schon immer die Funktion „mb_check_encoding“ um eventuell nötige Konvertierungen zu entdecken. Leider ist in manchen WordPress/PHP-Installationen die dafür nötige PHP-Bibliothek „Multibyte String“ nicht installiert. Dann funktioniert das Plugin nicht. Nun wird auf die Verfügbarkeit der Funktion „mb_check_encoding“ getestet: Falls sie nicht vorhanden ist, wird auf die Konvertierungsfunktion verzichtet.
• In den Plugin-Optionen kann ein „Bearer“-Zugangsschlüssel für oAuth-Bearer-Authentifizierung festgelegt werden. Der dort definierte Zugangsschlüssel wird an die API als „Authorization:Bearer accesskey“ geschickt. Bei manchen APIs reicht es aus, nur „Authorization:accesskey“ zu schicken, d. h. ohne „Bearer „. Dazu bitte „nobearer “ (mit einem Leerzeichen am Ende) an den Start dieses Optionen-Feldes hinzufügen.

1.2.18

• Plugin funktioniert mit WordPress 4.7.5
• Neue Option: Standrad Browserkennung („USeragent“) kann einem http-Anfrage hinzugefügt werden (manche APIs benötigen dies)

1.2.17

• Plugin funktioniert mit WordPress 4.7
• Plugin-Website nun mit https statt http
• Entferne ungültige Anführungszeichen in den Shortcode-Attributen (das kann beim Kopieren und dann Einfügen von Beispielcode leider passieren)

1.2.16

• Plugin funktioniert mit WordPress 4.6.1
• Plugin funktioniert mit PHP 7.0
• Verbesserter Code

1.2.15

• Plugin funktioniert mit WordPress 4.5.2
• Plugin für zukünftige Erweiterungen vorbereitet

1.2.14

• Plugin funktioniert mit WordPress 4.5
• Verbesserte Beschreibung

1.2.13

• Bug im Cacher behoben: WordPress 4.4.2 erzeugt selbst nicht das Verzeichnis „/cache/“ . Falls „/cache/“ fehlt, erzeugt das Plugin es. Das betrifft komplett neue WordPress Installationen, während in älteren Installationen dieses Verzeichnis bereits vorhanden ist.

1.2.12

• Plugin funktioniert mit WordPress 4.4
• Kleinere Fehlerkorrektur: Direkten Aufruf des Plugins verhindern
• Fehlerkorrektur: Pfad der gecachtetn Dateien wird nun richtig gesetzt

1.2.11

• Fehlerkorrektur: Probleme mit numerischen JSON-Daten und Feld-Manipulatoren wie {JSONkey:ifNotEmptyAdd:….} gelöst
• Feature der BetaVersion 0.2: Fehler in der Nutzung des oAuth-Bearer-Zugriffscodes zur Authentifizierung beim API-JSON-Server: Der Bearer-Code wird dem http-Header hinzugefügt

1.2.10

• Fehlerkorrektur: Caching funktioniert nun asuch mit sehr langen URLs
• Beta, experimentelles Feature: Auf der Optionen-Seite des Plugins kannst Du einen oAuth-Bearer-Accesscode zur Authentifizierung beim JSON-Server eintragen: Dieser Bearer-Code wird dem Anfrage-Header hinzugefügt.

1.2.9

• Neu: „{street:purejsondata}“: Standardmäßig wird HTML in JSON-.Daten nicht als interpretiertes HTML angeziegt, sondern HTML-Tags werden in HTML konvertiert. Falls Du den unverfälschten JSON-Datensatz ausgeben willst, füge „:purejsondata“ hinzu. Beispiel: Versuche zunächst {street}, dann {street:html} und schließlich {street:purejsondata}. Manchmal: Sorge dafür, dass „meta http-equiv=content-type…“ auf der Seite auf „utf-8“ gesetzt ist.

1.2.8

• Fehlerkorrektur: Verarbeitung von JSON-Daten mit $

1.2.7

• WordPress 4.3.1: Plugin funktioniert damit
• Fehlerkorrektur: Richtige Encodierung von Leerzeichen bei der Nutzung von {FIELD:html}
• Fehlerkorrektur: Lösche nicht im Template ersetzte Elemente, die Punkte enthalten

1.2.6

• WordPress 4.3: Plugin funktioniert damit
• hinzugefügtes Feature: Entferne nicht gefüllte Platzhalter im Template {…}
• Start von „JSON Content Importer PRO“

1.2.5

• WordPress 4.2.3: Plugin funktioniert damit
• Kleinere Fehlerkorrektur für „ifNotEmptyAddRight“
• Neue Pluginwebsite: http://json-content-importer.com/

1.2.4

• „&“ in JSON-Feed-URLs werden ersetzt durch „&“

1.2.3

• Ein durch eine spende ermöglichte Erweiterung hinzugefügt: Neue shortcode-parameter „oneofthesewordsmustnotbein“, „oneofthesewordsmustnotbeindepth“. Damit kann man JSON-daten bei der Darstellung undberücksichtigt lassen. Wenn eines der mit „,“-getrennten Schlüsselworte bei „oneofthesewordsmustnotbein“ im auszugebenden Textblock gefunden wird, wird dieser Textblock nicht ausgegeben.

1.2.2

• Kleinere Fehlerkorrektur:JSON-Strukturen wie { „$a“: „$b“} können verarbeitet werden (davor: „$“ verursache Probleme)

1.2.1

• Neues Attribut „{street:htmlAndLinefeed2htmlLinefeed}“: Im ausgegebenen Text werden Zeilenumbrüche in JSON-Datenfeld zur HTML-Zeilenumbrüchen verwandelt
• Vor dieser Version wurden „Boolean JSON-Datenwerte“ ignoriert. Nun wird ihnen der Text „true“ bzw. „False“ zugewiesen.
• Fehlerkorrektur Cacher: Timeout-Parameter des Cachers wurde nicht richtig verwendet
• Fehlerkorrektur falls ein JSON-Datenfeld „$“-Zeichen enthält

1.2.0

• Neue Shortcode Parameter: „oneofthesewordsmustbein“ und“oneofthesewordsmustbeindepth“
• filter und hook für Erweiterungen Dritter hinzugefügt. „hook“ ist „json_content_importer_extension“ und „filter“ ist „json_content_importer_result_root“
• Im Quelltext die PHP-Klassen neu arrangiert
• Kleinere Fehlerkorrektur: Anzahl der Elemente in subloop/subloop-array wurde manchmal ignoriert und alles wurde dargestellt
• „hergestellt in München“ ergänzt (siehe FAQs)

1.1.2

• Fehlerkorrektur: Tags wie „{aa/aa}“ sind verarbeitbar (davor wurde eine Fehlermeldung ausgegeben)
• Stelle JSON-HTML-Daten als interpretiertes HTML dar. Standardeinstellung: JSON-HTML-Daten werden nicht als HTML sondern als HTML-Text dargestellt. Neu in dieser Version: tag-syntax wie „{tag:html}“ oder „{street:html,ifNotEmptyAddRight:extratext}“ ermöglicht die Darstellung als interpretiertem HTML.
• Neuer Parameter im „[jsoncontentimporter]“-shortcode möglich: Setze http-timeout „urlgettimeout“. Standard ist 5 (Sekunden) (hilfreich wenn die Quellwebsite für JSON langsam ist)
• Logo des Plugins: WordPress-Logo eingefügt
• Screenshorts aktualisiert

1.1.1

Fehler behoben

1.1.0

Komplett überarbeitete Templateengine, um JSON besser verarbeiten zu können

• „subloop-array“: Der Schlüsselbegriff muss auch im schließenden Tag vorhanden sein, also z. B. „{subloop-array:KEY:10}{some_array_field}{/subloop-array:KEY}“.
  Der „subloop-array“ ohne KEY im schließenden Tag funktioniert, falls es nur ein „subloop-array“ im template gibt. Falls aber mehr als ein „subloop-array“ im template ist, füge das schließende Tag mit KEY hinzu!
  Dann kann die template engine die JSON-daten richtig verarbeiten.

• „subloop“: Was für „subloop-array“ (s.o.) gilt, gilt auch für „subloop“, also z. B. „{subloop:KEY:10}{some_object_field}{/subloop:KEY}“

• templates wie „{subloop-array:AAAA:10}{text}{subloop:AAAA.image:10}{id}{/subloop:AAAA.image}{/subloop-array:AAAA}“ sind möglich:
  Einerseits ist das die rekursive Nutzung von „subloop-array“ und „subloop“.
  Andererseits ist über „{subloop:AAAA.image:10}“ mit „AAAA.image“ der Pfad im JSON-Objekt definierbar.

• JSON-Daten in denen mehrfache Arrays vorkommen können durch die Templateengine verarbeitet werden

1.0.5

• Screenshot hinzugefügt
• „subloop-array“ erweitert, Daten in string/numerischen Arrays wird verbessert verarbeitet(zuvor: nur Daten in einem On object konnten verarbeitet werden)
• Erweiterte FAQs: Link zur Plugin-Website hinzugefügt. Dort finden sich weitere Informationen zu den Shortcode-Einstellungen.

1.0.4

Fehler behoben

1.0.3

Erweiterte Templatenegine, mit der JSON besser verarbeitet werden kann.

1.0.2

Erstveröffentlichung auf WordPress.org