WP-DraftsForFriends

Popis

Tento plugin vygeneruje jedinečný odkaz, který můžete poslat kamarádovi, aby si mohl přečíst příspěvek ještě předtím, než jej zveřejníte. Odkaz funguje i pro uživatele, kteří nejsou přihlášeni a nemají účet; otevře se pouze ten konkrétní příspěvek, pro který byl vygenerován, a přestane fungovat sám od sebe, jakmile uplyne vámi nastavená doba.

Vše probíhá na stránce Příspěvky -> WP-DraftsForFriends: vyberte nezveřejněný příspěvek, zadejte, jak dlouho má odkaz platit, a zkopírujte odkaz, který se vám zobrazí. Níže uvedený seznam zobrazuje všechny vaše aktivní odkazy, dobu jejich platnosti a umožňuje vám je prodloužit nebo zrušit. Nastavení najdete na druhé záložce téže stránky.

Funkce „Sdílení“ využívá oprávnění publish_posts namísto manage_options: plugin určený ke sdílení vlastních konceptů nemá žádný důvod požadovat oprávnění, které by někomu umožňovalo měnit nastavení webu.

Upraveno podle „Drafts for Friends“, původní autor: Neville Longbottom. Ikona pluginu pochází od Freepik z Flaticon.

Funkce

• Jedinečný 32znakový odkaz pro každý sdílený příspěvek, platný pouze pro příspěvek, ke kterému byl vydán
• Doba platnosti, kterou si zvolíte v sekundách, minutách, hodinách nebo dnech, s výchozím nastavením, které zadáte jednou
• Funguje i pro odhlášeného návštěvníka bez účtu
• Sdílet lze jak naplánované a čekající příspěvky, tak i koncepty
• Seřaditelný a stránkovaný seznam všech vašich odchozích odkazů s uvedením zbývající doby platnosti každého z nich
• Hromadné prodloužení nebo zrušení odkazů
• U sdíleného konceptu jsou komentáře povinně deaktivovány
• Přesunutím příspěvku do koše dojde ke zrušení odkazů v něm obsažených; obnovením příspěvku se tyto odkazy znovu zobrazí
• Kompatibilní s více weby, včetně aktivace v síti

Dary

Většinu svého volného času jsem věnoval tvorbě, aktualizaci, údržbě a podpoře těchto pluginů. Pokud se vám moje pluginy opravdu líbí a mohli byste mi věnovat pár dolarů, velmi bych to ocenil. Pokud ne, můžete je klidně používat bez jakýchkoli závazků.

Použití

Přejděte na Příspěvky -> WP-DraftsForFriends. Stránka obsahuje dvě záložky: Sdílené koncepty a Nastavení.

V části Sdílet koncept vyberte nezveřejněný příspěvek, nastavte dobu platnosti odkazu a klikněte na Sdílet koncept. Odkaz se zobrazí v seznamu níže; kliknutím na Kopírovat odkaz jej zkopírujte do schránky a pošlete ho komukoli, kdo jej potřebuje.

Seznam zobrazuje všechny vaše odchozí odkazy. Platnost končí za se odpočítává a poté se zobrazí Vypršela platnost. Najednou se zobrazuje dvacet řádků, všechny sloupce kromě sloupce s odkazy lze seřadit a pomocí Možnosti obrazovky můžete změnit počet zobrazených řádků.

Chcete-li prodloužit platnost odkazů, nastavte Prodloužit o na dobu, o kterou chcete platnost prodloužit, zaškrtněte příslušné řádky, vyberte Prodloužit vybrané a stiskněte Použít. Chcete-li je zrušit, zaškrtněte řádky a vyberte Zrušit vybrané. V obou případech se jedná o hromadné akce, nikoli o odkazy v jednotlivých řádcích, a to záměrně: odkaz je GET, a prohlížeč nebo nástroj pro kontrolu odkazů, který by jej tiše přednačítal, by zrušil veškeré sdílení na stránce, než byste si toho vůbec všimli.

Na záložce Nastavení se nastavuje doba, po kterou bude nové sdílení platné. Jedná se pouze o výchozí hodnotu — jak formulář sdílení, tak Prodloužit o lze pro jednotlivé sdílení změnit, aniž by se změnilo toto nastavení. Tato záložka využívá manage_options, takže autor vidí záložku Sdílené koncepty a nikoli záložku Nastavení.

Každý, kdo má oprávnění edit_others_posts – tedy správci a redaktoři – vidí všechny sdílené koncepty na webu a může sdílet jakýkoli nezveřejněný příspěvek. Autoři a přispěvatelé vidí pouze své vlastní příspěvky a mohou sdílet pouze ty, které mají oprávnění upravovat.

WP-CLI

wp draftsforfriends list --user=admin
wp draftsforfriends create 42 --user=admin
wp draftsforfriends create 42 --expires=14 --measure=d --user=admin
wp draftsforfriends extend 3 4 5 --expires=1 --measure=d --user=admin
wp draftsforfriends revoke 3 --yes --user=admin

create prints the share link on a line of its own before its success message, and `list` prints one per row. **A share link is the credential** — whoever holds it reads the unpublished post until the link expires, with no account and no login — so treat the output of both as you would the drafts themselves. Shell history, a CI log and a captured `stdout` are all places those links now live.

Pass --user. WP-CLI běží jako „nobody“, pokud není stanoveno jinak, a každý z těchto příkazů má přesně stejný rozsah, jak je zobrazeno na obrazovce: sdílení patří tomu, kdo jej vytvořil, kdokoli s oprávněním edit_others_posts je vidí všechny a při vytváření, rozšiřování nebo zrušení sdílení se ověřuje, zda můžete upravovat příspěvek, na který odkazuje. Při spuštění jako uživatel „nobody“ příkaz list nevrátí žádný výstup a ostatní příkazy jsou odmítnuty.

--expires and `--measure` default to the duration on the **Settings** tab, the same value the share form and **Extend by** start on. `extend` and `revoke` take as many ids as you like, exactly as the bulk actions do. `revoke` asks before it acts, because the link stops working immediately and cannot be restored; `--yes` answers for a script.

Pro tato nastavení neexistuje žádný podpříkaz – jedná se o jeden řádek s volbami, který wp option get wp_draftsforfriends_options již načítá.

Filtry

wp_draftsforfriends_capability decides who may reach each tab. The context is `shares` for the Shared Drafts tab or `settings` for the Settings tab:

add_filter( 'wp_draftsforfriends_capability', function ( $capability, $context ) {
    return 'settings' === $context ? 'manage_options' : 'edit_posts';
}, 10, 2 );

wp_draftsforfriends_share_url filters the link a friend is given, and
wp_draftsforfriends_requested_hash reads the hash back off the request. **They

tvoří jednu smlouvu.** Změňte formát odkazu, aniž byste plugin naučili
jej rozpoznat, a každý odkaz ke sdílení vyhodí chybu 404, přičemž na administračních obrazovkách
všechno vypadá v pořádku:

add_filter( 'wp_draftsforfriends_share_url', function ( $url, $share ) {
    return home_url( '/secret/' . $share->hash . '/' );
}, 10, 2 );

add_filter( 'wp_draftsforfriends_requested_hash', function ( $hash ) {
    if ( '' !== $hash ) {
        return $hash;
    }

    $path = isset( $_SERVER['REQUEST_URI'] ) ? sanitize_text_field( wp_unslash( $_SERVER['REQUEST_URI'] ) ) : '';

    return preg_match( '#/secret/([A-Za-z0-9]+)/#', $path, $m ) ? $m[1] : '';
} );

Výchozí odkaz je ?p=<id> namísto trvalého odkazu na příspěvek, a nejedná se o
opomenutí: náhled funguje tak, že zachytí řádek, který WordPress načte na základě samotného
ID příspěvku, a před vykreslením jej vrátí zpět. Trvalý odkaz vyhledává příspěvek podle slugu
mezi veřejnými stavy, takže nezveřejněný příspěvek není vůbec nalezen.

Akcie

V průběhu životního cyklu sdíleného souboru se spustí tři procesy, přičemž každý z nich se spustí poté, co
dojde k úspěšnému zápisu:

• wp_draftsforfriends_share_created — uložené sdílení a příspěvek, který je prostřednictvím něj sdílen.
• wp_draftsforfriends_share_extended — aktuální stav sdílení a
  doba platnosti, kterou mělo dříve.
• wp_draftsforfriends_share_revoked — sdílení tak, jak bylo; odkaz již
  přestal fungovat.

add_action( 'wp_draftsforfriends_share_created', function ( $share, $post ) {
    error_log( sprintf( 'Shared "%s" until %s', $post->post_title, $share->date_expired ) );
}, 10, 2 );