SOQVER Przygotuj źródło
Polski

SO4AG Facts dla WordPress

Bezpłatna wtyczka publikuje informacje o firmie na jej własnej stronie, aby asystenci AI i inne programy mogły z nich poprawnie korzystać. Określa, co obowiązuje, kogo dotyczy i do kiedy jest ważne. Ceny, godziny otwarcia, płatności, dostawa, anulowanie i gwarancja.

Pobierz wtyczkę (ZIP, wersja 0.1.0) Przeczytaj instrukcję

Bezpłatna, bez konta i bez płatnych funkcji. Współpracuje z WooCommerce. Wymaga WordPress 6.4 lub nowszej wersji oraz PHP 7.4 lub nowszej wersji. Licencja GPL-2.0-or-later.

Co wtyczka dodaje do witryny

Plik dla programów

https://your-site.com/so4ag.json

Wszystkie fakty w otwartym formacie SO4AG. Każdy może je odczytać bez klucza i rejestracji.

Strona dla czytelników

Tabela „Fakty i warunki” na dowolnej stronie pokazuje każdy fakt, jego wartość, kogo dotyczy i do kiedy obowiązuje.

Tabelę można dodać za pomocą bloku lub krótkiego kodu [so4ag_facts].

Dane strukturalne

Te same fakty w formacie JSON-LD (schema.org) w kodzie tej strony, dostępne dla wyszukiwarek i narzędzi, które już odczytują JSON-LD.

Jak to działa

1. Wprowadzanie faktów

W panelu administracyjnym WordPress. W WooCommerce wystarczy na początek jedno kliknięcie, by wtyczka zasugerowała ceny dostawy i metody płatności na podstawie ustawień sklepu.

2. Potwierdzanie faktów

Żadne informacje nie są publikowane automatycznie. Publikacja wymaga wyraźnego potwierdzenia, że fakty są zgodne z prawdą.

3. Publiczny dostęp do faktów w trzech formach

Plik, strona i dane JSON-LD zawsze zawierają tę samą, ostatnią potwierdzoną wersję. Niedokończone zmiany pozostają prywatne.

4. Wtyczka pilnuje terminów ważności

Każdy fakt ma określony ostatni dzień obowiązywania. Dwa tygodnie wcześniej w panelu administracyjnym pojawia się przypomnienie o sprawdzeniu i ponownym potwierdzeniu faktu.

Co zawiera każdy fakt

Instrukcja krok po kroku

Nazwy kart i przycisków podano poniżej w brzmieniu używanym we wtyczce.

Spis treści: 1. Instalacja · 2. Państwa firma · 3. Dodawanie faktów · 4. Warunki · 5. WooCommerce · 6. Publikacja · 7. Strona · 8. Sprawdzanie · 9. Aktualizacja faktów · 10. llms.txt · 11. Rozwiązywanie problemów

1. Instalacja wtyczki

  1. Proszę pobrać plik ZIP z tej strony. W panelu administracyjnym WordPress proszę otworzyć Plugins → Add New → Upload Plugin, wskazać pobrany plik i wybrać Install Now.
  2. Proszę wybrać Activate. W menu panelu administracyjnego pojawi się nowa pozycja SO4AG Facts.

2. Informacje o firmie

Na karcie Business proszę sprawdzić nazwę firmy, wybrać rodzaj działalności i opcjonalnie dodać identyfikatory rejestrowe (schemat i wartość, np. ein i numer EIN lub vat i numer VAT). Dane kontaktowe do zgłaszania poprawek są opcjonalne i po podaniu będą publicznie dostępne.

3. Dodawanie faktów

Na karcie Facts proszę wskazać rodzaj faktu i wybrać Add. Dla każdego faktu formularz ma cztery pola:

  1. Wartość, We do not state this lub It does not apply to us.
  2. Warunki (Applies to) obejmują tylko te, od których faktycznie zależy dany fakt.
  3. Ostatni dzień obowiązywania (Applies until).
  4. Strona w witrynie, na której podano tę informację (Page that states it). Jeśli pole pozostanie puste, fakt zostanie opublikowany jako oświadczenie firmy.
FaktGdzie szukaćWymagany warunekNajdłuższy
Operatorstopka, regulamin–400 dni
Lokalizacjaadres i godziny otwarcia na stronie kontaktowej–180 dni
Kontaktstrona kontaktowachannel180 dni
Cenacennikitem60 dni
Metody płatnościregulamin, finalizacja zamówienia–180 dni
Wymagana rezerwacja, Czas odpowiedzistrona rezerwacji, strona kontaktowa–90 dni
Bezpłatne anulowanie, Opłata za anulowaniezasady anulowania–90 dni
Gwarancjawarunki gwarancji–180 dni
Przyjmuje nowych klientówstrona kontaktowa–30 dni
Koszt dostawystrona z informacjami o dostawiecountry, delivery_method60 dni
Bezpłatna dostawa od, Opłata za pobraniestrona z informacjami o dostawiecountry / –60 dni
Termin zwrotu, Okres gwarancjizasady zwrotów, regulamin–180 dni

Wtyczka oferuje 25 faktów dla każdej firmy i 10 dla sklepu internetowego. „Maksymalny okres” to najdłuższy okres, na jaki można jednorazowo potwierdzić fakt. Wtyczka nie przyjmuje późniejszej daty.

4. Jak stosować warunki

5. Sklep z WooCommerce

Przycisk Suggest from the shop odczytuje ustawienia sklepu i przygotowuje sugestie:

Dla każdej sugestii należy wybrać jedną z opcji: Accept, Complete lub Dismiss. Sugestie nie są publiczne. Wtyczka informuje w uwadze o danych, których nie może odczytać z ustawień, takich jak cena wyliczana według wzoru, darmowa wysyłka dostępna wyłącznie z kuponem i przewoźnicy z innych wtyczek.

6. Potwierdzanie i publikowanie

Karta Confirm and publish pokazuje, co zostanie opublikowane i co zmieniło się od ostatniego potwierdzenia. Proszę zaznaczyć pole potwierdzające, że fakty są dziś zgodne z rzeczywistością, i wybrać Confirm and publish. Od tej chwili wszystkie zmiany pozostaną niepubliczne do czasu ponownego potwierdzenia.

Aby wycofać fakty z publikacji, proszę użyć opcji Withdraw na tej samej karcie. Fakty w wersji roboczej zostaną zachowane.

7. Wyświetlanie faktów na stronie

Na karcie Output and check proszę wybrać Create a draft page "Facts and terms", przejrzeć stronę, opublikować ją i dodać odnośnik w stopce. Aby umieścić fakty na własnej stronie, proszę dodać blok Facts and terms lub krótki kod:

[so4ag_facts]
[so4ag_facts heading="no"]
[so4ag_facts level="h3"]

Wtyczka nie dodaje do witryny żadnych odnośników ani plakietek i nie zmienia treści generowanych przez inne wtyczki. JSON-LD pojawia się tylko na stronach, na których umieszczono fakty.

8. Sprawdzanie wyniku

  1. Na karcie Output and check proszę wybrać Check the public addresses too. Wtyczka sprawdzi strukturę pliku, daty i zgodność faktów na stronie z faktami w pliku.
  2. Proszę otworzyć adres pliku w przeglądarce: https://your-site.com/so4ag.json
  3. Aby dodatkowo sprawdzić plik, proszę wkleić jego adres do publicznego walidatora.

9. Dbanie o aktualność danych

Po upływie terminu ważności fakt pozostaje w pliku, ale programy traktują go jako informację historyczną, a tabela oznacza go jako nieaktualny. Panel administracyjny ostrzega o upływie terminu z 14-dniowym wyprzedzeniem. Proponowany harmonogram:

10. llms.txt

Wtyczka może udostępniać pod adresem /llms.txt krótki plik wskazujący, gdzie znajdują się fakty. Funkcja jest domyślnie wyłączona. Można ją włączyć na karcie Output and check. Jeśli witryna ma już plik llms.txt, wtyczka go nie zmienia i pokazuje wiersze, które można dodać samodzielnie.

11. Rozwiązywanie problemów

ObjawRozwiązanie
/so4ag.json zwraca komunikat „nie znaleziono”Serwer WWW nie przekazał żądania dotyczącego tego adresu do WordPress. Proszę włączyć przyjazne bezpośrednie odnośniki (Settings → Permalinks) lub poprosić dostawcę hostingu o przekazywanie do WordPress żądań dotyczących brakujących plików. Do tego czasu działa adres /?so4ag_facts=json.
Sprawdzenie wykazuje, że strona zawiera inne fakty niż plikPamięć podręczna przechowuje starszą kopię strony. Proszę ją wyczyścić i sprawdzić ponownie.
Na stronie brakuje JSON-LDNa stronie nie ma ani bloku, ani krótkiego kodu lub motyw nie wywołuje wp_footer().
Wtyczka odrzuca datęKażdy rodzaj faktu ma maksymalny okres, na jaki można go potwierdzić. Proszę wybrać wcześniejszą datę i później ponownie potwierdzić fakt.
Witryna działa przez httpPlik jest dostępny, ale programy oczekują dostępu przez https.

Czego wtyczka nie robi

Dla programistów i agencji

Czy zajmują się Państwo tworzeniem lub utrzymaniem witryn klientów? Za wprowadzenie faktów rozliczają się Państwo bezpośrednio z klientem. Ponieważ fakty mają ograniczony okres ważności, ktoś musi je regularnie weryfikować. Jeśli klient wykupi także monitoring w SOQVER, w ramach programu partnerskiego otrzymają Państwo część opłaty abonamentowej. Konto i fakty należą do klienta.

Program partnerski Format i narzędzia dla programistów

Pakiet zawiera kod źródłowy wtyczki na licencji GPL-2.0-or-later. SO4AG to otwarty format w wersji roboczej. Specyfikacja, walidator i narzędzia do odczytu są bezpłatne. Specyfikacja · GitHub

Często zadawane pytania

Czy potrzebuję konta lub płatnej usługi?

Nie. Sama wtyczka obsługuje wprowadzanie i publikowanie faktów, plik, stronę, JSON-LD oraz sprawdzanie.

Czy wtyczka współpracuje z moją wtyczką SEO?

Tak. Wtyczka nie zmienia treści generowanych przez inne wtyczki. Dodaje własny blok JSON-LD tylko na stronach, na których umieszczono fakty.

Co się dzieje po upływie terminu ważności faktu?

Fakt pozostaje w pliku, ale programy traktują go jako informację historyczną, a tabela oznacza go jako nieaktualny. Proszę go sprawdzić, ustawić nową datę i ponownie potwierdzić.

Co zostanie usunięte po skasowaniu wtyczki?

Ustawienia wtyczki, fakty w wersji roboczej i wersja opublikowana. Utworzone przez Państwa strony pozostaną w witrynie bez tabeli.

Pobierz wtyczkę (ZIP, wersja 0.1.0)