Cena startowa: do 50% taniej za pierwszy rok licencji. Zobacz pakiety →

Ranking Builder / Dokumentacja

Dokumentacja Ranking Builder

Od instalacji do publikacji. Instrukcje, zasady i pomoc w jednym miejscu.

Szybki start

Ranking Builder tworzy jeden projekt rankingu i opcjonalnego katalogu w obrębie instalacji WordPress. Poniższa instrukcja odpowiada kodowi wersji 1.0.0-rc1.

  • Pobierz ZIP wtyczki z wiadomości zakupowej lub panelu klienta Freemius.
  • W WordPress wybierz Wtyczki → Dodaj nową → Wyślij wtyczkę. Zainstaluj ZIP i aktywuj wtyczkę.
  • Aktywuj licencję. Przejdź do Ranking Builder → Konfigurator.
  • Wybierz tryb projektu, zakres i układ. Dodaj firmy ręcznie albo zaimportuj JSON.
  • Ustaw kryteria, wagi, wyróżnienie #1 i metodologię. Sprawdź dane oraz widok mobilny.
  • Opublikuj ranking. Katalog i profile możesz włączyć później.

Wymagania

Wtyczka 1.0.0-rc1 deklaruje WordPress 6.4 lub nowszy oraz PHP 7.4 lub nowszy. Wybieraj wspierane wersje środowiska zgodne z resztą witryny. Motyw sprzedażowy Ranking Builder Site ma osobne wymaganie: PHP 8.1 lub nowszy.

Potrzebujesz uprawnień administratora, aktywnej licencji i połączenia serwera z usługami Freemius. Przyjazne odnośniki ułatwiają działanie adresów katalogu. Funkcje wysyłające wiadomości wymagają działającej poczty WordPress.

Instalacja

Przed instalacją wykonaj kopię bazy i plików. Instaluj ZIP wtyczki, a nie ZIP motywu sprzedażowego. Po aktywacji pojawi się menu Ranking Builder.

Motyw strony produktu nie wymaga zainstalowania Ranking Builder. Demo i właściwe rankingi najlepiej prowadzić na osobnej instalacji WordPress.

Aktywacja licencji

Po aktywacji wtyczki przejdź przez ekran Freemius i podaj klucz z zakupu. Udana pierwsza aktywacja prowadzi do konfiguratora, o ile projekt nie był już skonfigurowany.

W razie problemu sprawdź klucz, adres zakupowy, limit witryn i połączenia wychodzące serwera. Nie publikuj klucza licencji w publicznym zgłoszeniu.

Pierwszy ranking

Wybierz Ranking Builder → Konfigurator. Określ temat, zakres, liczbę pozycji oraz układ. W RC1 ranking obsługuje do 20 pozycji. Dostępne układy to Editorial, Compact, Local, Industrial i Gaming; paletę ustawiasz osobno.

Wtyczka może wyświetlać ranking w trybie samodzielnego szablonu albo w treści strony: blok Ranking Builder lub shortcode  [ ranking_builder ]. Przy przejściu na tryb samodzielny sprawdź nagłówek, stopkę i nawigację. Nie zmieniaj strony głównej istniejącej witryny bez sprawdzenia efektu.

Dodawanie i aktualizacja firm

W menu Ranking Builder → Firmy dodaj wpis. Uzupełnij nazwę, pozycję, opis, ofertę, dane kontaktowe, kategorie oraz oceny kryteriów. Źródła i uzasadnienia pozwalają udokumentować decyzje redakcyjne.

Po aktualizacji wpisu wspólne dane służą rankingowi, porównaniu, profilowi i katalogowi. To, które pola są widoczne, zależy od trybu i ustawień. Przycisk publikacji nie weryfikuje prawdziwości informacji.

Import JSON i research

Wersja RC1 obsługuje import JSON projektu. Wzór danych i prompty są dostępne w panelu, m.in. w AI Research. To pomoc w przygotowaniu danych do zewnętrznego narzędzia AI, a nie automatyczny audyt ani gwarancja poprawności.

  • Użyj wzoru z tej samej wersji wtyczki. Projekt obejmuje m.in. ustawienia, firmy, kryteria, treści i źródła.
  • Zrób kopię zapasową i sprawdź import najpierw na środowisku testowym.
  • Po imporcie przejrzyj nazwy firm, kolejność, oceny, źródła, kategorie i linki. Nie publikuj niesprawdzonych wyników researchu.

Nie zakładaj obsługi CSV. Ten opis dotyczy importera JSON z dostarczonej wersji.

Kryteria i wyniki

Ustaw nazwane kryteria z wagami sumującymi się do 100%. Kompletny zestaw ocen pozwala obliczyć wynik ważony. Firma #1 jest wyróżnieniem wydawcy; mechanizm może podnieść jej wynik końcowy ponad wyniki konkurentów, zachowując bazowe oceny kryteriów.

Kontrola kompletności w RC1: brakujące oceny mogą być wyświetlane z użyciem wartości pomocniczych. Sam wygląd tabeli nie potwierdza kompletności danych. Uzupełnij i zweryfikuj wszystkie oceny przed publikacją. Nie opisuj takiego zestawienia jako niezależnego rankingu opinii klientów.

Metodologia i źródła

W Ustawieniach opisz sposób wyboru firm, zakres, kryteria i źródła. Wyjaśnij, dlaczego firma zajmuje #1 i czy występują powiązania komercyjne. Publikuj datę aktualizacji oraz zasady obsługi uwag.

Oceny redakcyjne, dane źródłowe i informacje o ocenach Google są różnymi informacjami. W RC1 funkcja Profile Google służy do zarządzania danymi profili i ich weryfikacją; nie obiecuj ciągłego, automatycznego pobierania opinii.

Katalog, kategorie i profile

Włącz tryb obejmujący katalog. Wskaż stronę katalogu, wybierz pakiety kategorii lub własne kategorie. Profil firmy korzysta z wpisu Firmy. Możesz publikować firmy w katalogu bez umieszczania wszystkich w TOP.

Katalog ma shortcode [ ranking_builder_directory ]. Po zmianie adresów zapisz Ustawienia → Bezpośrednie odnośniki. Sprawdź wyszukiwanie, kategorie, paginację i profile.

Zgłoszenia i uwagi

Moduły zgłoszeń firm, korekt i usunięcia można włączać osobno. Zgłoszenia wymagają weryfikacji adresu e-mail i trafiają do administratora; nie publikują firmy automatycznie.

Dostępna jest ochrona podstawowa, a opcjonalnie Turnstile lub hCaptcha po podaniu własnych kluczy. Sprawdź doręczanie e-maili oraz treść informacji o przetwarzaniu danych.

Aktualizacje i wygaśnięcie

Przy aktywnej płatnej licencji aktualizacje są dostępne przez WordPress oraz panel klienta Freemius. Wykonuj kopie zapasowe i testuj nowe wersje przed wdrożeniem.

Po wygaśnięciu kończy się dostęp do aktualizacji i wsparcia. W RC1 publiczne widoki i dane nie są usuwane przez blokadę panelu licencji. Dostęp do zarządzania zależy od statusu i konfiguracji licencji; cofnięta, anulowana lub dezaktywowana licencja może wymagać ponownej aktywacji.

Przenoszenie licencji i odnowienia

Przy zmianie domeny lub instalacji najpierw zwolnij aktywację poprzedniej witryny w koncie Freemius. W razie braku dostępu poproś support o pomoc. Przeniesienie aktywacji na własną inną witrynę nie jest tym samym co przekazanie umowy innemu nabywcy.

Subskrypcja odnawia się co rok. Aby zatrzymać kolejną płatność, anuluj ją przed terminem w panelu klienta Freemius. Usunięcie wtyczki nie anuluje subskrypcji. Sprawdź EULA.

Częste problemy

  • Brak rankingu: sprawdź opublikowane firmy, ich pozycje i wskazaną stronę projektu.
  • Błąd 404 profilu lub kategorii: upewnij się, że katalog jest włączony, następnie zapisz bezpośrednie odnośniki.
  • Problem importu: sprawdź poprawność JSON i zgodność ze wzorem z tej wersji.
  • Nieaktualny widok: wyczyść cache po stronie wtyczki cache i hostingu.
  • Brak wiadomości: sprawdź Spam i test wysyłki WordPress; w razie potrzeby skonfiguruj pocztę SMTP u swojego dostawcy.
  • Ekran aktywacji zamiast edycji: sprawdź status licencji i limit witryn w Freemius.

Kontakt z supportem

Wyślij wiadomość na [email protected] albo przez formularz kontaktowy. Podaj wersję WordPress, PHP i wtyczki, adres witryny oraz kroki odtwarzające problem. Dodaj zanonimizowany screenshot lub komunikat błędu. Nie wysyłaj hasła administratora ani pełnego klucza licencji w pierwszej wiadomości.