Jak to działa
Rankden automatycznie publikuje wygenerowane artykuły na Twojej stronie. Po skonfigurowaniu integracji, każdy artykuł — nowy, zaktualizowany lub usunięty — jest synchronizowany ze wszystkimi podłączonymi platformami jednocześnie.
Podłącz platformę
Skonfiguruj integrację w panelu — podaj dane dostępowe.
Generuj artykuły
Rankden tworzy treść zoptymalizowaną pod SEO.
Automatyczna publikacja
Artykuły trafiają na Twoją stronę automatycznie.
WordPress
Wymagania
- WordPress 5.0+
- Zainstalowany plugin Rankden
- Dostęp administratora do WordPress
Konfiguracja krok po kroku
Zainstaluj plugin Rankden na WordPress
Pobierz plik .zip pluginu z panelu Rankden. W panelu WordPress przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer. Wybierz pobrany plik, kliknij Zainstaluj teraz i aktywuj plugin.
Skonfiguruj integrację w Rankden
Przejdź do Dashboard → Integracje → WordPress. Wpisz Webhook URL — adres Twojej strony WordPress (plugin poda dokładny URL po aktywacji). Kliknij Wygeneruj przy polu API Key, skopiuj klucz i wklej go w ustawieniach pluginu na WordPress.
Weryfikacja
Po zapisaniu integracji, przy kolejnej publikacji artykułu z Rankden post automatycznie pojawi się na Twoim WordPress.
Dane konfiguracyjne
Webhook URLURL endpointu pluginu Rankden na Twojej stronie WordPressAPI KeyKlucz wygenerowany w panelu Rankden (skopiuj przed zapisaniem)Obsługiwane akcje
Tworzy nowy post
Aktualizuje istniejący
Usuwa post
Wix
Wymagania
- Konto Wix z aktywną stroną
- Blog zainstalowany na stronie Wix
- API Key wygenerowany w Wix Dashboard
Konfiguracja krok po kroku
Wygeneruj API Key w Wix
Zaloguj się na manage.wix.com. Przejdź do Settings → API Keys i kliknij Generate API Key. Nadaj nazwę (np. "Rankden") i przyznaj uprawnienia:
Znajdź Account ID i Site ID
Account ID — znajdziesz w Settings → Account Settings.
Site ID — spójrz na URL w przeglądarce po zalogowaniu do Wix Dashboard:
manage.wix.com/dashboard/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/...Fragment po /dashboard/ to Twoje Site ID.
Skonfiguruj integrację w Rankden
Przejdź do Dashboard → Integracje → Wix. Wklej API Key, Account ID i Site ID. Kliknij Podłącz.
Dane konfiguracyjne
API KeyKlucz wygenerowany w Wix Dashboard → API KeysAccount IDID konta Wix (Settings → Account Settings)Site IDID strony — widoczny w URL dashboardu po /dashboard/Obsługiwane elementy
Ograniczenia
Cofnięcie publikacji — Wix API nie obsługuje cofania publikacji posta. Jeśli zmienisz status artykułu na „wersję roboczą" w Rankden, post na Wix pozostanie opublikowany. Cofnięcie publikacji wymaga ręcznej akcji w panelu Wix.
Custom API
Integracja Custom API pozwala podłączyć Rankden do dowolnej platformy lub CMS-a. Rankden wysyła request HTTP POST na podany przez Ciebie endpoint z danymi artykułu.
Konfiguracja
Przygotuj endpoint na swoim serwerze
Twój serwer musi mieć endpoint przyjmujący requesty POST z treścią artykułu.
Skonfiguruj w Rankden
Przejdź do Dashboard → Integracje → Custom. Wpisz Endpoint URL i wygeneruj API Key.
Format requestu
POST https://twoja-strona.pl/api/blog
Content-Type: application/json
X-API-Key: sk_twoj_klucz_apiStruktura body
{
"action": "create | update | delete",
"article": {
"id": "653bb91e-4c28-...",
"title": "Tytuł artykułu",
"slug": "tytul-artykulu",
"content": {
"blocks": [
{
"type": "header",
"data": { "text": "Nagłówek", "level": 2 }
},
{
"type": "paragraph",
"data": { "text": "Treść akapitu..." }
},
{
"type": "list",
"data": {
"style": "unordered",
"items": ["Element 1", "Element 2"]
}
}
]
},
"htmlContent": "<h2>Nagłówek</h2><p>Treść...</p>",
"meta": {
"title": "Meta tytuł SEO",
"description": "Meta opis SEO"
},
"featuredImage": "https://...image.png",
"excerpt": "Krótki opis artykułu",
"status": "published"
}
}Pola artykułu
actionstringcreate, update, delete lub testarticle.idUUIDUnikalny identyfikator artykułuarticle.titlestringTytuł artykułuarticle.slugstringSlug URLarticle.contentobjectTreść w formacie EditorJS (bloki)article.htmlContentstringTreść skonwertowana do HTMLarticle.metaobjectMeta title i description (SEO)article.featuredImagestring / nullURL zdjęcia okładkiarticle.statusstringpublished lub draftPrzykładowy endpoint (Node.js / Express)
app.post('/api/blog', (req, res) => {
const apiKey = req.headers['x-api-key'];
if (apiKey !== process.env.RANKDEN_API_KEY) {
return res.status(401).json({ error: 'Unauthorized' });
}
const { action, article } = req.body;
switch (action) {
case 'create':
// Zapisz nowy artykuł
break;
case 'update':
// Zaktualizuj istniejący
break;
case 'delete':
// Usuń artykuł
break;
case 'test':
// Test połączenia
break;
}
res.json({ success: true, id: 'new-article-id' });
});Oczekiwana odpowiedź
{ "success": true, "id": "..." }{ "error": "Opis błędu" }Test połączenia
Przy pierwszym zapisaniu integracji Rankden wyśle request testowy z action: "test"i przykładowymi danymi. Twój endpoint powinien zwrócić status 200.
FAQ
Czy mogę podłączyć wiele platform jednocześnie?
Tak. Każda integracja działa niezależnie. Artykuł może być jednocześnie publikowany na WordPress, Wix i dowolnym custom endpoint.
Co się stanie jeśli usunę integrację?
Usunięcie integracji w Rankden nie usuwa artykułów z platformy docelowej. Artykuły pozostaną na WordPress / Wix / custom, ale nie będą już synchronizowane.
Czy mogę edytować artykuł bezpośrednio na WordPress / Wix?
Tak, ale zmiany nie zostaną zsynchronizowane z powrotem do Rankden. Przy kolejnej edycji w Rankden Twoje zmiany na platformie docelowej zostaną nadpisane.
Czy API Key jest bezpieczny?
Tak. Klucze API są szyfrowane w bazie danych algorytmem AES-256-GCM. Po zapisaniu są widoczne tylko jako kropki. Wygeneruj nowy klucz, jeśli podejrzewasz wyciek.
Synchronizacja nie działa — co zrobić?
Sprawdź czy dane konfiguracyjne są poprawne (URL, klucze, ID). Upewnij się, że platforma docelowa jest dostępna. Dla Wix: sprawdź uprawnienia API Key (Blog Posts, Members, Media Manager). Dla Custom API: sprawdź czy endpoint odpowiada statusem 200/201.