Várólista — WordPress bővítmény (V1)

Várólista-kezelő rendszer WordPresshez: nyilvános jelentkezési űrlap, a jelentkezők adminisztrációja és a kapcsolatfelvételi folyamat követése.

Nem időpontfoglaló rendszer: nem kezel naptárat, időpontot, szabad helyet, sorszámot vagy várakozásiidő-becslést, és a publikus oldalon semmilyen várólista-pozíciót nem jelenít meg.

A repó neve UT-Waitlist, a bővítmény neve Várólista, a slugja és a fordítási tartománya varolista.

Telepítés

1. A repó tartalmát másold a WordPress wp-content/plugins/varolista/ könyvtárába — vagy telepítsd a kiadott ZIP-et a Bővítmények oldalon.
2. A Bővítmények oldalon aktiváld a Várólista bővítményt.
3. Az aktiválás létrehozza az adatbázistáblákat, és az Adminisztrátor szerepkörnek megadja a manage_waitlist jogosultságot.
4. Illeszd be az űrlapot bármelyik oldalba a shortcode-dal:

[varolista_form]

Shortcode paraméterek (opcionálisak):

• [varolista_form notice="0"] — a tájékoztató blokk elrejtése ezen az oldalon.
• [varolista_form title="Saját cím"] — egyedi űrlapcím.

Adminisztráció

Várólista főmenü, almenük:

• Jelentkezők — státuszonkénti összesítő, jelentkezői táblázat (alapértelmezés: jelentkezés dátuma növekvő, azaz a legrégebbi legfelül), helyben módosítható státusz, jelentkezői adatlap.
• Űrlap — az űrlap szövegei, az adatvédelmi nyilatkozat, a tájékoztató blokk és a választható szolgáltatások listája (hozzáadás, átnevezés, sorrend, ki-be kapcsolás).
• Beállítások — feladó és címzettek, a két e-mail-sablon, adattörlési beállítás.

Státuszok

Minden státuszváltás naplózódik: korábbi és új státusz, időpont és a módosítást végző WordPress-felhasználó.

Jogosultság

A bővítmény saját capability-t használ: manage_waitlist. Enélkül a jelentkezők listája, adatlapja, megjegyzései és elérhetőségei nem érhetők el.

Más szerepkörnek így adható meg (pl. egy kis kódrészletben vagy egy szerepkör-kezelő bővítménnyel):

get_role( 'editor' )->add_cap( 'manage_waitlist' );

Vagy aktiválás előtt a szűrővel:

add_filter( 'varolista_default_roles', function ( $roles ) {
    $roles[] = 'editor';
    return $roles;
} );

Adatmodell

Saját táblák (nem wp_posts), a {prefix} a WordPress tábla-előtagja:

• {prefix}_waitlist_entries — jelentkezők
• {prefix}_waitlist_notes — belső megjegyzések
• {prefix}_waitlist_contacts — kapcsolatfelvételi napló
• {prefix}_waitlist_status_log — státuszelőzmények

E-mailek

Két e-mail megy ki új jelentkezéskor: visszaigazolás a jelentkezőnek és értesítés az admin címekre. Mindkettő tárgya és tartalma szerkeszthető a Beállítások oldalon.

Helyettesítő kulcsok: {name}, {email}, {phone}, {applicant_type}, {child_name}, {child_birth_year}, {service}, {description}, {created_at}, {status}, {admin_link}, {site_name}, {site_url}, {id}.

Biztonság

• Nonce és capability ellenőrzés minden admin és frontend műveletnél.
• Minden bemenet sanitizálva, minden kimenet escape-elve.
• Kizárólag prepared SQL lekérdezések.
• Honeypot mező és időzítés-ellenőrzés a frontend űrlapon (CAPTCHA nélkül).

Megjelenés

A bővítmény minimális saját CSS-t tölt be. A fő elemek stabil osztálynevei:

.varolista-wrapper  .varolista-notice  .varolista-form  .varolista-form__title
.varolista-field    .varolista-label   .varolista-input .varolista-select
.varolista-textarea .varolista-radios  .varolista-checkbox
.varolista-submit   .varolista-success .varolista-field__error

A CSS teljesen kikapcsolható, ha a sablon saját stílust ad:

add_action( 'wp_enqueue_scripts', function () {
    wp_dequeue_style( 'varolista-public' );
}, 100 );

Horgok fejlesztőknek

• varolista_entry_created ( $entry ) — új jelentkező mentése után.
• varolista_status_changed ( $entry_id, $new_status, $old_status ).
• varolista_email_tokens ( $tokens, $entry ) — saját helyettesítő kulcsok.
• varolista_contact_types ( $types ) — kapcsolatfelvétel-típusok.
• varolista_entries_per_page ( $per_page ) — lista oldalmérete.
• varolista_default_roles ( $roles ) — mely szerepkörök kapják a capability-t.

Eltávolítás

A bővítmény törlésekor az adatok alapértelmezés szerint megmaradnak. Ha véglegesen törölni szeretnéd őket, előbb kapcsold be a Beállítások oldal alján a megfelelő jelölőnégyzetet.