Webhelyek képességei

A MainWP 30 webhelykezelő képességet regisztrál a mainwp-sites kategóriában. Ezekkel programból listázhatod, szűrheted, hozzáadhatod, frissítheted és törölheted a webhelyeket, kezelheted a kapcsolatukat, a rajtuk lévő bővítményeket és témákat, és lekérheted a biztonsági, változás- és költségadatokat.

A hívások általános szabályait (alap URL, hitelesítés, metódusok, bemenet átadása) az Abilities API áttekintése írja le. Az alábbi példák curl -u 'admin:xxxx' hitelesítéssel és az https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/ alap URL-lel értendők. A webhelyet a site_id_or_domain mezőben azonosítóval vagy tartománnyal adhatod meg.

Áttekintés

Képesség	Metódus	Mire jó
mainwp/list-sites-v1	GET	Webhelyek listája lapozással és szűréssel
mainwp/get-site-v1	GET	Egy webhely részletes adatai
mainwp/count-sites-v1	GET	Webhelyek száma
mainwp/get-sites-basic-v1	GET	Minimális adatok (azonosító, URL, név) az összes webhelyről
mainwp/sync-sites-v1	POST	Szinkronizálás egy vagy több webhelyen
mainwp/add-site-v1	POST	Új webhely hozzáadása
mainwp/update-site-v1	POST	Webhely tulajdonságainak módosítása
mainwp/delete-site-v1	POST	Webhely törlése (megerősítéssel)
mainwp/reconnect-site-v1, mainwp/reconnect-sites-v1	POST	Újracsatlakozás (egy, illetve több webhely)
mainwp/disconnect-site-v1, mainwp/disconnect-sites-v1	POST	Kapcsolat bontása
mainwp/suspend-site-v1, mainwp/suspend-sites-v1	POST	Webhely felfüggesztése
mainwp/unsuspend-site-v1	POST	Felfüggesztés feloldása
mainwp/check-site-v1, mainwp/check-sites-v1	POST	Elérhetőség ellenőrzése
mainwp/get-site-plugins-v1	GET	Egy webhely bővítményei
mainwp/activate-site-plugins-v1	POST	Bővítmények aktiválása
mainwp/deactivate-site-plugins-v1	POST	Bővítmények kikapcsolása
mainwp/delete-site-plugins-v1	POST	Bővítmények törlése (megerősítéssel)
mainwp/get-site-themes-v1	GET	Egy webhely témái
mainwp/activate-site-theme-v1	POST	Téma aktiválása
mainwp/delete-site-themes-v1	POST	Témák törlése (megerősítéssel)
mainwp/get-abandoned-plugins-v1	GET	Elhagyott bővítmények az összes webhelyen
mainwp/get-abandoned-themes-v1	GET	Elhagyott témák az összes webhelyen
mainwp/get-site-security-v1	GET	Biztonsági adatok
mainwp/get-site-changes-v1	GET	Változásnapló (Logs modul kell)
mainwp/get-site-client-v1	GET	A webhelyhez tartozó ügyfél
mainwp/get-site-costs-v1	GET	Költségkövetési adatok (Cost Tracker modul kell)

Webhelyek listázása és lekérdezése

mainwp/list-sites-v1

A MainWP-hez csatlakoztatott webhelyek listája lapozással és szűréssel. Csak olvas, GET.

curl -u 'admin:xxxx' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/list-sites-v1/run'

Név	Típus	Kötelező	Alapérték	Leírás
page	egész	nem	1	Oldalszám (1-től)
per_page	egész	nem	20	Elemek oldalanként (1-100)
status	szöveg	nem	any	Szűrő: any, connected, disconnected, suspended
search	szöveg	nem	üres	Keresés a névben vagy az URL-ben
client_id	egész	nem		Szűrés ügyfélazonosítóra
tag_id	egész	nem		Szűrés címkeazonosítóra

A válasz egy items tömb (azonosító, url, name, status, client_id), valamint a page, per_page és total mező.

mainwp/get-site-v1

Egy webhely részletes adatai. GET.

curl -G -u 'admin:xxxx' \
  --data-urlencode 'input_json={"site_id_or_domain":1,"include_stats":true}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/get-site-v1/run'

Név	Típus	Kötelező	Alapérték	Leírás
site_id_or_domain	egész vagy szöveg	igen		Webhelyazonosító vagy tartomány/URL
include_stats	logikai	nem	false	Frissítésszámok és egészségi pontszám hozzáadása

A válasz az alapadatok mellett a WordPress- és PHP-verziót (wp_version, php_version), az utolsó szinkronizálást (last_sync), a rendszergazda nevét (admin_username), a MainWP Child verzióját (child_version) és a jegyzeteket (notes) tartalmazza. Ha include_stats igaz, a stats objektum a plugin_updates, theme_updates, wp_update_available és health_score értékeket adja.

mainwp/count-sites-v1

A webhelyek száma. Egyetlen bemenete a status (any, connected, disconnected, suspended; alapértéke any). A válasz: {"total": 150}.

mainwp/get-sites-basic-v1

Minimális adat (azonosító, URL, név) az összes webhelyről, bemenet nélkül. A válasz a sites tömb és a total.

Szinkronizálás

mainwp/sync-sites-v1

Szinkronizálást indít egy vagy több webhelyen. Legfeljebb 200 webhelyet azonnal elvégez, a 200-nál többet háttérfeladatként sorba állítja.

# Meghatározott webhelyek szinkronizálása
curl -X POST -u 'admin:xxxx' \
  -H 'Content-Type: application/json' \
  -d '{"input":{"site_ids_or_domains":[1, 2, 3]}}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/sync-sites-v1/run'

# Az összes webhely szinkronizálása (üres tömb)
curl -X POST -u 'admin:xxxx' \
  -H 'Content-Type: application/json' \
  -d '{"input":{"site_ids_or_domains":[]}}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/sync-sites-v1/run'

Név	Típus	Kötelező	Alapérték	Leírás
site_ids_or_domains	tömb	nem	[]	Webhelyazonosítók vagy tartományok; üresen az összes webhely

Azonnali válasz (legfeljebb 200 webhely):

{
  "queued": false,
  "synced": [
    {"id": 1, "url": "https://site1.example.com", "name": "1. webhely"}
  ],
  "errors": [],
  "total_synced": 1,
  "total_errors": 0
}

Sorba állított válasz (több mint 200 webhely):

{
  "queued": true,
  "job_id": "sync_abc123def456",
  "status_url": "https://a-te-vezerlopultod.hu/wp-json/mainwp/v2/jobs/sync_abc123def456",
  "sites_queued": 350
}

A sorba állított feladat állapotát a Kötegelt műveletek fejezet szerint kérdezheted le.

Webhely hozzáadása, módosítása, törlése

mainwp/add-site-v1

Új webhelyet ad a vezérlőpulthoz. POST.

curl -X POST -u 'admin:xxxx' \
  -H 'Content-Type: application/json' \
  -d '{"input":{"url":"https://uj-weboldal.example.com","admin_username":"admin","name":"Új webhely","uniqueid":"xxxxx"}}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/add-site-v1/run'

Név	Típus	Kötelező	Alapérték	Leírás
url	szöveg	igen		A webhely URL-je
admin_username	szöveg	igen		Rendszergazda felhasználóneve a gyermekwebhelyen
name	szöveg	igen		A webhely megjelenített neve
client_id	egész	nem		Hozzárendelés ügyfélhez
tag_ids	tömb	nem		Hozzárendelendő címkék azonosítói
http_user	szöveg	nem		HTTP-hitelesítés felhasználóneve
http_pass	szöveg	nem		HTTP-hitelesítés jelszava
adminpassword	szöveg	nem		A WordPress-rendszergazda jelszava; kötelező, ha a gyermekwebhelyen be van kapcsolva a jelszavas hitelesítés
uniqueid	szöveg	nem		A MainWP Child egyedi biztonsági azonosítója; kötelező, ha az egyedi biztonsági azonosító be van kapcsolva, vagy a jelszavas hitelesítés ki van kapcsolva
verify_certificate	egész	nem	2	0 kikapcsolja a tanúsítvány ellenőrzését, 1 ellenőrzi, 2 a globális beállítást használja
ssl_version	egész	nem	0	A cURL SSL-verziójának kiválasztása; 0 az automatikus felismerés

A MainWP Child legalább egy hitelesítési módot megkövetel: add meg az adminpassword, a uniqueid vagy mindkét értéket, a gyermekwebhely MainWP Child beállításainak megfelelően. Rendszergazdai jelszó használatakor tartsd bekapcsolva a tanúsítvány ellenőrzését, és használj HTTPS-t. Az ssl_version értékét hagyd 0-n, hacsak a tárhelyed nem kér konkrét cURL SSL-verziót. A válasz a létrehozott webhely objektuma, ugyanolyan szerkezetben, mint a get-site-v1 válasza.

mainwp/update-site-v1

Meglévő webhely tulajdonságainak módosítása. POST.

curl -X POST -u 'admin:xxxx' \
  -H 'Content-Type: application/json' \
  -d '{"input":{"site_id_or_domain":1,"name":"Új név","notes":"Új jegyzet"}}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/update-site-v1/run'

Név	Típus	Kötelező	Leírás
site_id_or_domain	egész vagy szöveg	igen	Webhelyazonosító vagy tartomány
name	szöveg	nem	A webhely megjelenített neve
notes	szöveg	nem	Jegyzetek
client_id	egész	nem	Ügyfélazonosító (null leválasztja az ügyfelet)
tags	tömb	nem	Címkeazonosítók (lecserélik a meglévőket)

A válasz a módosított webhely objektuma.

mainwp/delete-site-v1

Törli a webhelyet a MainWP-ből. Romboló művelet, megerősítést kér. POST.

curl -X POST -u 'admin:xxxx' \
  -H 'Content-Type: application/json' \
  -d '{"input":{"site_id_or_domain":1,"confirm":true}}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/delete-site-v1/run'

Név	Típus	Kötelező	Alapérték	Leírás
site_id_or_domain	egész vagy szöveg	igen		Webhelyazonosító vagy tartomány
confirm	logikai	igen		true kell hozzá a törlés megerősítéséhez
dry_run	logikai	nem	false	Előnézet törlés nélkül

A válasz: {"deleted": true, "site_id": 1, "site_url": "…"}.

Kapcsolat és elérhetőség

Az alábbi képességek mindegyike POST, és a site_id_or_domain mezőt várja. A válaszban a művelet eredményét jelző logikai mező, a site_id, a site_url és az új állapot (status) szerepel.

Képesség	Mit csinál	Válaszmező
mainwp/reconnect-site-v1	Újracsatlakoztat egy lekapcsolódott webhelyet	reconnected, status: connected
mainwp/disconnect-site-v1	Bontja a kapcsolatot: a webhely az adatbázisban marad, de a kommunikáció le van tiltva	disconnected, status: disconnected
mainwp/suspend-site-v1	Felfüggeszti a webhelyet; a felfüggesztett webhelyek kimaradnak a szinkronizálásból és a frissítési műveletekből	suspended, status: suspended
mainwp/unsuspend-site-v1	Feloldja a felfüggesztést	unsuspended, status: connected
mainwp/check-site-v1	Ellenőrzi a webhely elérhetőségét	reachable, response_time_ms, http_status

Az ellenőrzés válasza például:

{
  "site_id": 1,
  "site_url": "https://site1.example.com",
  "reachable": true,
  "response_time_ms": 245,
  "http_status": 200
}

Kötegelt változatok

A mainwp/reconnect-sites-v1, mainwp/disconnect-sites-v1, mainwp/suspend-sites-v1 és mainwp/check-sites-v1 több webhelyen végzi el ugyanazt. Mindegyik POST, és a site_ids_or_domains tömböt várja:

• az újracsatlakoztatásnál (reconnect-sites-v1) a tömb nem kötelező, üresen az összes lekapcsolódott webhelyet érinti,
• az elérhetőség-ellenőrzésnél (check-sites-v1) a tömb nem kötelező, üresen az összes webhelyet ellenőrzi,
• a kapcsolat bontásánál (disconnect-sites-v1) és a felfüggesztésnél (suspend-sites-v1) a tömb kötelező.

Az újracsatlakoztatás, bontás és felfüggesztés válasza a sikeres webhelyek listája (reconnected, disconnected, suspended), az errors tömb, valamint az összesítő számok (például total_reconnected, total_errors). Az ellenőrzés válasza a results tömb (site_id, site_url, reachable, response_time_ms) és a summary (total_checked, reachable, unreachable). 200 webhelynél többen ezek is háttérfeladatként futnak.

Bővítmények kezelése egy webhelyen

mainwp/get-site-plugins-v1

A gyermekwebhelyre telepített bővítmények listája. GET.

curl -G -u 'admin:xxxx' \
  --data-urlencode 'input_json={"site_id_or_domain":1,"status":"active"}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/get-site-plugins-v1/run'

Név	Típus	Kötelező	Alapérték	Leírás
site_id_or_domain	egész vagy szöveg	igen		Webhelyazonosító vagy tartomány
status	szöveg	nem	all	Szűrő: all, active, inactive
has_update	logikai	nem		Csak a frissítéssel rendelkező bővítmények

A válasz a plugins tömb (slug, name, version, active, update_version) és a total.

Aktiválás, kikapcsolás, törlés

Képesség	Mit csinál	Bemenet	Válasz
mainwp/activate-site-plugins-v1	Aktiválja a megadott bővítményeket	site_id_or_domain, slugs (mindkettő kötelező)	activated, errors
mainwp/deactivate-site-plugins-v1	Kikapcsolja a megadott bővítményeket	site_id_or_domain, slugs (mindkettő kötelező)	deactivated, errors
mainwp/delete-site-plugins-v1	Törli a megadott bővítményeket	site_id_or_domain, slugs, confirm (mind kötelező)	deleted, errors

A slugs a bővítmény fájlútja a mappanévvel (például akismet/akismet.php). A törléshez a confirm értéke true kell legyen, mert a művelet romboló.

curl -X POST -u 'admin:xxxx' \
  -H 'Content-Type: application/json' \
  -d '{"input":{"site_id_or_domain":1,"slugs":["hello-dolly/hello.php"],"confirm":true}}' \
  'https://a-te-vezerlopultod.hu/wp-json/wp-abilities/v1/abilities/mainwp/delete-site-plugins-v1/run'

Témák kezelése egy webhelyen

Képesség	Mit csinál	Bemenet	Válasz
mainwp/get-site-themes-v1 (GET)	Kilistázza a telepített témákat	site_id_or_domain	active_theme, themes (slug, name, version, active, update_version), total
mainwp/activate-site-theme-v1 (POST)	Aktivál egy témát	site_id_or_domain, slug (mindkettő kötelező)	activated, previous_theme
mainwp/delete-site-themes-v1 (POST)	Törli a megadott témákat	site_id_or_domain, slugs, confirm (mind kötelező)	deleted, errors

A témák törlése romboló művelet, ezért a confirm: true itt is kötelező.

Elhagyott bővítmények és témák

A mainwp/get-abandoned-plugins-v1 és a mainwp/get-abandoned-themes-v1 az összes webhelyen kilistázza az elhagyott elemeket. Elhagyottnak az számít, amely két éve vagy régebben nem kapott frissítést. Mindkettő GET, és két nem kötelező bemenete van: page (alapérték 1) és per_page (alapérték 50).

A válasz az items tömb (site_id, site_url, slug, name, version, last_updated) és a total.

Biztonság, változásnapló, ügyfél, költségek

mainwp/get-site-security-v1

A webhely biztonsági adatai. GET, bemenete a site_id_or_domain. A válasz a security_issues tömb (type, severity, message) és az ssl_status (valid, expires).

mainwp/get-site-changes-v1

A webhely változás- és tevékenységnaplója. GET. A Logs modul aktív állapotát kéri; ha a modul nem aktív, mainwp_module_not_available hibát kapsz.

Név	Típus	Kötelező	Alapérték	Leírás
site_id_or_domain	egész vagy szöveg	igen		Webhelyazonosító vagy tartomány
page	egész	nem	1	Oldalszám
per_page	egész	nem	50	Elemek oldalanként

A válasz a changes tömb (id, type, description, user, timestamp) és a total.

mainwp/get-site-client-v1

A webhelyhez rendelt ügyfél. GET, bemenete a site_id_or_domain. A válasz a client objektum (id, name, email, status).

mainwp/get-site-costs-v1

A webhely költségkövetési adatai. GET, bemenete a site_id_or_domain. A Cost Tracker modul aktív állapotát kéri, különben mainwp_module_not_available hibát ad. A válasz a costs tömb (id, name, amount, frequency, next_due), a total_monthly és a total_yearly.