WordPress.org

Česko

Získejte WordPress
WordPress.org

Plugin Directory

WP-Stats

WP-Stats

Autor: Lester Chan
Stáhnout

Popis

WP-Stats vytvoří stránku se statistikami pro váš blog na základě údajů, které již máte v databázi: kolik je příspěvků, stránek, komentářů, štítků, kategorií a odkazů, které příspěvky přilákaly nejvíce komentářů, kdo komentoval nejčastěji a kdo pro vás píše. Vložte na stránku zkrácený kód [page_stats] a tato stránka se stane vaší stránkou se statistikami. K dispozici je widget v postranním panelu pro souhrnné údaje a stejné statistiky se zobrazují také v wp-admin pod položkou WP-Stats.

Moje další pluginy mohou na tuto stránku přidávat své vlastní bloky. WP-Stats o nich nemusí předem nic vědět a nikdy nečte jejich nastavení.

Funkce

  • Kompletní stránka se statistikami pomocí jediného zkráceného kódu
  • Celkové počty příspěvků, stránek, komentářů, komentujících, štítků, kategorií, odkazů a autorů
  • X nejkomentovanějších příspěvků a stránek, nejnovější příspěvky a nejnovější komentáře
  • Zobrazení pro jednotlivé komentátory, které obsahuje seznam všech komentářů, které daná osoba zanechala, s paginací
  • Widget v postranním panelu pro součty
  • Každý blok lze vypnout samostatně

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í

Vytvořit stránku se statistikami

  1. Přejděte na WP-Admin -> Stránky -> Přidat novou
  2. Do pole pro název stránky zadejte libovolný název
  3. Pokud používáte „pěkné“ trvalé odkazy, WordPress vygeneruje trvalý odkaz na stránku poté, co zadáte název. Hned vedle trvalého odkazu uvidíte odkaz „Upravit“.
  4. Klikněte na „Upravit“, do textového pole zadejte stats a klikněte na „Uložit“.
  5. Do obsahu stránky zadejte [page_stats]
  6. Klikněte na „Zveřejnit“
  7. Pokud NEPOUŽÍVÁTE „nice permalinks“, přejděte na WP-Admin -> WP-Stats, otevřete záložku Nastavení a do pole „Stats URL“ zadejte adresu stránky, kterou jste právě vytvořili.

Blok

Statistiky blogu se nachází v editoru v sekci Widgety. Přidejte jej na stránku a tato stránka se stane vaší stránkou se statistikami – na samotném bloku není třeba nic nastavovat, protože to, co se na stránce zobrazuje, vychází z nastavení a z nainstalovaných doplňkových pluginů, nikoli z příspěvku.

Vykresluje se to na serveru, takže náhled v editoru představuje skutečnou stránku, nikoli jen její přibližnou podobu, a počty se při každém zobrazení počítají znovu, namísto toho, aby byly při uložení příspěvku „zamrzlé“.

Zkrácený kód stále funguje a nikam nezmizí. [page_stats] se chová přesně tak, jak vždy, a stránka, která jej již obsahuje, nevyžaduje žádné změny. Blok volá stejný kód jako zkrácený kód, takže se oba vykreslují identicky – včetně bloků, které přispívají jiné pluginy – a můžete použít ten, který se na danou stránku hodí.

Widget

  1. Přejděte na WP-Admin -> Vzhled -> Widgety
  2. Název widgetu je Stats.

Pro autory pluginů

Plugin přidá blok na stránku se statistikami tím, že zpracuje jeden filtr. Vraťte záznam, jehož klíčem je váš vlastní slug s podtržítky:

add_filter( 'wp_stats_sections', function ( $sections ) {
    $options = get_option( 'my_plugin_options', array() );

    if ( empty( $options['stats_display'] ) ) {
        return $sections;   // the site owner switched this block off
    }

    $sections['my_plugin'] = array(
        'title'    => __( 'My Plugin', 'my-plugin' ),
        'priority' => 10,
        'render'   => 'my_plugin_render_stats',
    );

    return $sections;
} );

function my_plugin_render_stats() {
    echo '<ul><li>42 things.</li></ul>';
}

title is a translated heading and is required. `render` is a callable that echoes the block body, takes no arguments, and is required. `priority` sorts the blocks and defaults to 10; ties are broken by the array key.

Na základě vlastního nastavení se rozhodněte, zda chcete vůbec přispívat, a pokud je odpověď „ne“, vraťte $sections beze změn, místo abyste přidávali záznam s prázdným tělem. WP-Stats nikdy nečte řádek s volbami jiného pluginu a nikdy nekontroluje, zda vaše třídy existují — pokud váš plugin není nainstalován, na filtr nikdo neodpoví a žádný blok se nezobrazí.

WP-Stats poté spustí akci wp_stats_section_my_plugin s vaším záznamem. Právě jeho vlastní posluchač této akce vypíše nadpis a zavolá funkci render, takže šablona může převzít blok jednoho pluginu, aniž by to ovlivnilo ostatní:

add_action( 'wp_stats_section_my_plugin', function ( $section ) {
    remove_action( 'wp_stats_section_my_plugin', array( 'WP_Stats_Page', 'render_section' ) );
    echo '<p>drawn by the theme instead</p>';
}, 5 );

Záznam s nesprávným formátem – nejedná se o pole, chybí název, nebo je render nevolatelný – bude přeskočen. Stránka se kvůli tomu nezhroutí a ani vás na to systém neupozorní, proto si zkontrolujte, zda se váš blok zobrazuje.

Snímky obrazovky

Stats -> Statistiky: stránka, na které je pak samostatná sekce pro každý plugin, který k nim přispívá
Stats -> Statistiky: stránka, na které je pak samostatná sekce pro každý plugin, který k nim přispívá
Karta „Nastavení“, na které se volí obsah zprávy a widgetu
Karta „Nastavení“, na které se volí obsah zprávy a widgetu
Stránka se statistikami, kterou vidí návštěvník, z krátkého kódu
Stránka se statistikami, kterou vidí návštěvník, z krátkého kódu
Widget v postranním panelu
Widget v postranním panelu

Bloky

Tento plugin poskytuje 1 blok.

  • Blog Statistics The whole statistics page: totals, listings, and whatever other plugins contribute.

Instalace

  1. Nainstalujte a aktivujte plugin.
  2. Vytvořte stránku a vložte do ní zkrácený kód [page_stats], nebo přidejte blok Stats. Tato stránka se stane vaší stránkou se statistikami. Níže uvedený návod obsahuje kompletní postup.
  3. Stejné statistiky najdete v wp-admin pod WP-Stats a pro souhrnné údaje je k dispozici widget v postranním panelu.

Moje další pluginy po instalaci přidávají na tuto stránku své vlastní sekce. WP-Stats o nich nemusí předem nic vědět.

Nejčastější dotazy

Jaké možnosti plugin ukládá?

Dva řádky. wp_stats_options obsahuje adresu URL stránky se statistikami, limit „top X“ a přepínače zobrazení; wp_stats_version zaznamenává verzi, která byla naposledy spuštěna, aby při aktualizaci bylo jasné, z jaké verze se aktualizuje. Odstranění pluginu z obrazovky Pluginy odstraní obě tyto položky.

Mám plugin, který čte `get_option( ‚stats_display‘ )`. Bude to fungovat i nadále?

Ano. Tento řádek se při aktualizaci odstraní a verze 3.0.0 již na něj nereaguje. Tento řádek dříve sdílelo sedm pluginů, což znamenalo, že žádný z nich nemohl změnit způsob jeho uložení, aniž by tím narušil fungování ostatních šesti. Uchovejte si vlastní kopii tohoto nastavení ve svém vlastním řádku možností a odpovězte na wp_stats_sections — viz část „Pro autory pluginů“ výše.

Zmizel nadpis „Statistiky pluginů“

Zobrazuje se to nyní pouze v případě, že plugin skutečně poskytl nějaký blok. Před verzí 3.0.0 se to zobrazovalo bez ohledu na to, zda pod tím něco bylo, či nikoli.

Proč se mi počty autorů zobrazují jinak?

Pojem „autoři“ nyní označuje uživatele, kteří mohou publikovat příspěvky, což je přesně to, co tento blok vždy uváděl jako kritérium. Dříve se tato hodnota odvozovala ze staršího metadatu user_level, přičemž byli vyloučeni všichni uživatelé, u nichž právě probíhal proces obnovy hesla.

Recenze

Worked right away

2. 11. 2016
Worked right away. Should be very informative for heavy bloggers. I don´t see a reason nor and argument for the 1 star reviews. Rate it 5 stars.

Disappointing

3. 9. 2016
Plugin works until you try to modify the settings. Author refuses to do his due diligence to fix the problems.

nice and tiny

3. 9. 2016
I don’t understand previous bad reviews on that plugin as it works fine. It’s very simple and informative, so I recommend it to everyone.
Přečtěte si všech 7 recenzí

Autoři

WP-Stats je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.

Spolupracovníci

Plugin „WP-Stats“ byl přeložen do 5 jazyků. Děkujeme všem překladatelům za jejich pomoc.

Přeložte “WP-Stats” do svého jazyka.

Zajímá vás vývoj?

Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.

Přehled změn

3.0.0

  • OPRAVENO: Sekce „Nejnovější příspěvky“ a „Nejkomentovanější“ nerespektovaly vlastní filtr webu posts_where. Funkce get_posts() ve výchozím nastavení potlačuje filtry, takže plugin pro členství nebo placený přístup, který skrýval publikované příspěvky, je i tak zobrazoval na veřejné stránce statistik — což bylo v rozporu s logikou, na které je založena zbylá část souboru, a sice že tyto dotazy procházejí API jádra právě proto, aby se i nadále uplatňovala pravidla obsahu daného webu.
  • OPRAVENO: Jedno ze tří míst, kde se vytváří odkaz na autora, neprovádělo únikovou konverzi URL a spoléhalo se místo toho na to, že volající nejprve zakódoval název. V současné době to sice platí, ale nic to nevynucuje.
  • AKTUÁLNÍ ZPRÁVA: Vyžaduje WordPress 6.8 a PHP 8.2, místo dosavadních verzí 6.0 a 7.4.
  • AKTUÁLNÍ ZPRÁVA: Řádky stats_url, stats_mostlimit, stats_display, stats_options a stats_db_version jsou nahrazeny sloupci wp_stats_options a wp_stats_version, které jsou při aktualizaci automaticky migrovány a následně smazány. Na staré názvy již není reagováno.
  • AKTUÁLNÍ ZPRÁVA: Filtr stats_page bez předpony se nyní nazývá wp_stats_page a je mu předána stránka včetně jejího obalového prvku.
  • AKTUÁLNÍ ZPRÁVA: Bylo odstraněno sedm filtrů wp_stats_page_*, dva filtry wp_stats_paging_* a sedm filtrů wp_stats_page_admin_*. Plugin, který přispívá blokem, reaguje na wp_stats_sections a vykresluje se prostřednictvím wp_stats_section_<slug>.
  • AKTUÁLNÍ ZPRÁVA: Funkce stats_display_defaults() byla odstraněna. Plugin si nyní uchovává vlastní nastavení zobrazení ve svém vlastním řádku možností.
  • AKTUÁLNÍ ZPRÁVA: Obrazovka se statistikami byla přesunuta z Dashboard –> WP-Stats a nastavení z Nastavení –> Statistiky na jednu stránku WP-Stats se dvěma záložkami, Statistiky a Nastavení, na adrese admin.php?page=wp-stats.
  • AKTUÁLNÍ ZPRÁVA: Každá třída má předponu. Třída widgetu je WP_Stats_Widget; umístěné widgety a jejich nastavení tím nejsou ovlivněny.
  • NOVINKA: Blok Statistiky blogu, wp-stats/page-stats, který zobrazuje stránku se statistikami v editoru i na veřejném webu. Zkratka [page_stats] zůstává beze změny a je i nadále podporována — blok volá stejný kód, takže se oba prvky zobrazují identicky a stránka, která již tuto zkratku používá, nevyžaduje žádné změny.
  • NOVINKA: wp_stats_sections a wp_stats_section_<slug> – rozhraní, které ostatní pluginy používají k přidání bloku na stránku statistik.
  • NOVINKA: wp_stats_capability – tato funkce se provádí při každé kontrole oprávnění, takže editorům lze umožnit přístup k záložce „Statistiky“ (pouze pro čtení) bez nutnosti otevírat nastavení.
  • NOVINKA: Struktura byla přepracována na includes/, kde každá třída odpovídá jedné oblasti odpovědnosti.
  • NOVINKA: Obrazovka nastavení byla přepracována na základě rozhraní API nastavení WordPressu.
  • NOVINKA: Sada testů PHPUnit a CI v GitHub Actions.
  • ZMĚNA: Stránka se statistikami je obalena tagy <div class="wp-stats"> a stylový list je omezen pouze na ni, takže již nemění vzhled stránkování pluginu WP-PageNavi a již se nezastaví při načítání, pokud je tento plugin aktivní.
  • ZMĚNA: Šablona stylů byla přesunuta do css/wp-stats.css a přebírá barvy šablony namísto pevně nastavené kombinace modré na bílém pozadí. Vlastní kopie souboru stats-css.css v šabloně se již nehledá; místo toho odstraňte z fronty identifikátor wp-stats.
  • ZMĚNA: Každý seznam je vytvořen pomocí základních dotazovacích API namísto ručně psaného kódu SQL, takže výsledky se ukládají do mezipaměti stejným způsobem jako zbytek systému WordPress a veškeré filtry, které web již používá ke skrytí obsahu, zůstávají v platnosti.
  • ZMĚNA: Počty v kolonce „Autoři“ představují uživatele, kteří mohou publikovat příspěvky, nikoli uživatele se starším user_level vyšším než 1.
  • ZMĚNA: stats_author a stats_page jsou nyní registrované proměnné dotazu.
  • OPRAVENO: Šablona se nikdy nenačítala, protože byla připojena k wp_enqueue_script, což není akce. Nyní se načítá na stránkách, na kterých se zobrazuje stránkování.
  • OPRAVENO: Při vykreslování stránky se statistikami již nedochází k přepsání globální proměnné $post, což mohlo způsobit, že smyčka šablony odkazovala na nesprávný záznam.
  • OPRAVENO: Odinstalace v prostředí s více weby se zastavila u stého webu a zbylé řádky sítě zůstaly neopravené.
  • OPRAVENO: Funkce get_linkcats() a get_tags_list() používaly argumenty a funkce, které jsou od verze WordPress 3.0 zastaralé.
  • OPRAVENO: Byla odstraněna nedostupná větev „Comments Protected“; každý výpis již vylučuje příspěvky chráněné heslem.
  • OPRAVENO: Záporný argument dotazu stats_page způsobil chybu SQL.
  • OPRAVENO: Komentátor, jehož jméno obsahuje apostrof nebo uvozovku – stačí například „Sinead O’Brien“ –, dostával prázdný seznam komentářů pod nadpisem, v němž se nacházel nadbytečný zpětný lomítko. Argument dotazu stats_author byl načten bez odstranění lomítek, které WordPress přidává ke každé hodnotě požadavku, takže jméno se nikdy neshodovalo s řádkem, ze kterého pocházelo.
  • OPRAVENO: Varování o nedefinovaném indexu při čtení souboru cookie po zadání hesla.
  • OPRAVENO: Popisek „Statistics To Display“ v widgetu používal nesprávnou textovou doménu, a proto nebylo možné jej přeložit.
  • OPRAVENO: V řádku widgetu věnovaném spamu se zobrazoval text „Spam Blockeds“ v množném čísle.
  • POZNÁMKA: U komentářů byla informace o autorovi uvedena jako „Zveřejnil“ připojená k jménu autora a datum jako „Dne“ připojené k datu; u odkazů byl název „Zveřejněno dne“ připojený k datu. Každý z nich je nyní tvořen jedním řetězcem se zástupnými symboly, takže o pořadí slov rozhoduje překlad. Tyto msgidy se změnily, takže stávající překlady těchto položek se do doby, než budou znovu přeloženy, zobrazují v angličtině.

Meta

Hodnocení

2.6 z 5 hvězdiček.

Your review

Zobrazit všechny recenze

Spolupracovníci

Podpora

Potřebujete pomoc?

Fórum podpory

Dary

Chtěli byste podpořit vývoj tohoto pluginu?

Přispět na tento plugin