n8n-nodes-artckle

Dies ist ein n8n Community Node, der die Integration mit Artckle CMS ermöglicht.

n8n ist eine Workflow-Automatisierungsplattform, mit der Sie Aufgaben über verschiedene Dienste hinweg automatisieren können.

Artckle ist ein Strapi-basiertes Content Management System mit erweiterten Features für:

• Content Management (Articles, Stories, Snippets, Pages, etc.)
• Media Management (Assets mit Geo-Location Support)
• Authentifizierung und Benutzerverwaltung
• KI-Features (OpenAI Integration)
• Workflow Management (Issues, Newspapers)

Installation

Folgen Sie der Installationsanleitung in der n8n-Dokumentation.

Community Nodes (empfohlen)

Für Benutzer von n8n Cloud oder selbst gehostetes n8n:

1. Gehen Sie zu Settings > Community Nodes
2. Wählen Sie Install
3. Geben Sie @martin_sol_95/n8n-nodes-artckle unter Enter npm package name ein
4. Akzeptieren Sie die Risiken und klicken Sie auf Install

Nach der Installation müssen Sie n8n neu starten, um den Node zu sehen.

Manuelle Installation

Um zu beginnen, installieren Sie das Paket in Ihrem n8n-Root-Verzeichnis:

npm install @martin_sol_95/n8n-nodes-artckle

Für Docker-basierte Bereitstellungen fügen Sie die folgende Zeile vor dem Schriftinstallationsbefehl in Ihrer n8n Dockerfile hinzu:

RUN cd /usr/local/lib/node_modules/n8n && npm install @martin_sol_95/n8n-nodes-artckle

Credentials

Dieser Node benötigt Artckle API Credentials. Sie können API-Credentials aus Ihren Artckle-Kontoeinstellungen erhalten.

Credential-Setup

1. Öffnen Sie n8n
2. Gehen Sie zu Credentials > New
3. Suchen Sie nach Artckle API
4. Geben Sie Ihre Credentials ein:
   • API URL: Die Base URL Ihrer Artckle-Instanz (z.B. https://api.artckle.com)
   • API Token: Ihr JWT Bearer Token
5. Klicken Sie auf Save

Operationen

Der Node unterstützt derzeit die folgenden Ressourcen und Operationen:

Article

• Get All: Alle Artikel abrufen
• Get: Einzelnen Artikel abrufen
• Create: Neuen Artikel erstellen
• Update: Bestehenden Artikel aktualisieren
• Export: Artikel exportieren

Erweiterte Optionen für Articles:

• Filters: Strapi-Filter-Query (z.B. filters[channel][id][$eq]=1)
• Populate: Relations laden (z.B. populate=* oder populate[story]=*)
• Sort: Sortierung (z.B. sort=name:asc)
• Pagination: Seitennummer und Seitengröße
• Fields: Auswahl der Felder

Issue

• Get All: Alle Issues abrufen
• Get: Einzelnes Issue abrufen
• Create: Neues Issue erstellen
• Update: Bestehendes Issue aktualisieren

Story

• Get All: Alle Stories abrufen
• Get: Einzelne Story abrufen
• Create: Neue Story erstellen
• Update: Bestehende Story aktualisieren

Verwendungsbeispiele

Beispiel 1: Alle Artikel abrufen

1. Fügen Sie einen Manual Trigger Node hinzu
2. Fügen Sie einen Artckle Node hinzu
3. Wählen Sie Article als Ressource
4. Wählen Sie Get All als Operation
5. Konfigurieren Sie zusätzliche Optionen nach Bedarf:
   • Limit: Anzahl der Ergebnisse begrenzen
   • Pagination: Seitennummer und Seitengröße
6. Führen Sie den Workflow aus

Beispiel 2: Channel-spezifische Artikel abrufen

1. Fügen Sie einen Manual Trigger Node hinzu
2. Fügen Sie einen Artckle Node hinzu
3. Wählen Sie Article als Ressource
4. Wählen Sie Get All als Operation
5. Fügen Sie unter Additional Options hinzu:
   • Filters: filters[channel][id][$eq]=1
   • Populate: populate[Section][populate][snippet]=*
   • Sort: sort=publication_time:desc
6. Führen Sie den Workflow aus

Beispiel 3: Neuen Artikel erstellen

1. Fügen Sie einen Manual Trigger Node hinzu
2. Fügen Sie einen Artckle Node hinzu
3. Wählen Sie Article als Ressource
4. Wählen Sie Create als Operation
5. Füllen Sie die erforderlichen Felder aus:
   • Title: Der Titel des Artikels
   • Body: Der Artikelinhalt (kann JSON sein)
6. Führen Sie den Workflow aus

Beispiel 4: Artikel im Zeitraum abrufen

Verwenden Sie Get All mit Filters:

filters[publication_time][$gte]=2024-01-01T00:00:00.000Z&filters[publication_time][$lte]=2024-01-31T23:59:59.999Z&filters[status][$eq]=published

Strapi Query-Parameter

Alle Collection-Type Endpunkte unterstützen folgende Query-Parameter:

• filters: Filtern der Ergebnisse (z.B. filters[name][$eq]=Test)
• populate: Laden von Relations (z.B. populate=* oder populate[story]=*)
• sort: Sortierung (z.B. sort=name:asc oder sort=name:desc)
• pagination[page] & pagination[pageSize]: Paginierung
• fields: Auswahl der Felder (z.B. fields[0]=name&fields[1]=status)

Kompatibilität

• Minimum n8n Version: 1.0.0
• Getestet mit n8n Version: 1.123.4+
• Node.js Version: 20.x oder höher

Ressourcen

• n8n Dokumentation
• Strapi Dokumentation
• Artckle Website

Versionshistorie

0.1.0 (Initial Release)

• Article Operationen (CRUD + Export)
• Issue Operationen (CRUD)
• Story Operationen (CRUD)
• Vollständige Unterstützung für Strapi Query-Parameter
• Support für Filters, Populate, Sort, Pagination

Lizenz

MIT

Support

Für Probleme, Fragen oder Beiträge:

• Erstellen Sie ein Issue im GitHub Repository
• Besuchen Sie das n8n Community Forum

Beiträge

Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.

Haftungsausschluss

Dies ist ein Community Node und ist nicht offiziell mit Artckle verbunden oder von Artckle unterstützt.

---

Author: Artckle
Version: 0.1.0
License: MIT