Motendo Widget

描述

Motendo Widget to wtyczka WordPress umożliwiająca wyświetlanie ogłoszeń z serwisu Motendo.com. Wersja 1.2 wprowadza szereg usprawnień, które zwiększają wydajność, bezpieczeństwo oraz elastyczność rozwiązania. Nowe funkcjonalności obejmują:

  • Nowa architektura obiektowa i przestrzeń nazw: Kod został przepisany na model obiektowy, co poprawia organizację oraz zmniejsza ryzyko konfliktów z innymi wtyczkami.
  • Mechanizm cache’owania: Wyniki zapytań do API są przechowywane w transients, co zmniejsza liczbę zapytań do zewnętrznego serwisu i poprawia szybkość działania.
  • Wykorzystanie http_build_query(): Budowanie URL do API odbywa się teraz za pomocą funkcji http_build_query(), co zwiększa czytelność kodu i bezpieczeństwo przesyłanych danych.
  • Output buffering oraz oddzielenie logiki prezentacji: Renderowanie HTML odbywa się przy użyciu output buffering, co ułatwia modyfikację szablonów i wprowadzanie filtrów.
  • Dodanie hooków i filtrów: Dzięki nowym filtrom (np. motendo_widget_output czy motendo_widget_transient_expiration) deweloperzy mogą łatwo rozszerzać funkcjonalność wtyczki.
  • Ulepszony panel ustawień: Rozbudowano opcje konfiguracyjne w panelu administracyjnym, m.in. dodano możliwość konfiguracji cache’owania i timeoutu zapytań.
  • Poprawiona obsługa błędów API: Wtyczka lepiej radzi sobie z błędami zewnętrznego API, wyświetlając przyjazne komunikaty użytkownikowi.

External Services

Ta wtyczka łączy się z zewnętrznym API dostarczanym przez Motendo.com w celu pobierania danych ogłoszeń. Oto szczegóły dotyczące tej usługi:

  • Adres API:
    Wtyczka wykonuje zapytania do API pod adresem:
    https://www.motendo.com/widget/

  • Wysyłane parametry:
    W zapytaniu wysyłane są następujące parametry:

    • source – określa rodzaj wyszukiwania (np. latesearch lub latest).
    • limit – liczba ogłoszeń do wyświetlenia.
    • lang – język ogłoszeń (np. pl, en, de, ua).
    • format – format danych zwracanych przez API (json lub html).
    • phrase – fraza wyszukiwania (jeśli nie zostanie podana, wykorzystywane są tagi wpisu).
    • user_id – opcjonalnie, identyfikator użytkownika dla pobierania spersonalizowanych danych.
  • Cel przesyłanych danych:
    Parametry te są wykorzystywane do pobrania odpowiednich ogłoszeń, które następnie są prezentowane na stronie. Żadne dane osobowe użytkownika nie są zapisywane przez wtyczkę; przesyłane dane służą jedynie do określenia treści wyświetlanych ogłoszeń.

  • Linki do regulaminów i polityki prywatności:
    Użytkownicy powinni być świadomi, że korzystanie z tej usługi odbywa się zgodnie z warunkami i polityką prywatności serwisu Motendo.com. Prosimy o zapoznanie się z:

  • Usługa a dane użytkownika:
    Przy każdym ładowaniu widgetu wykonywane jest zapytanie do API, co umożliwia dynamiczne pobieranie aktualnych ogłoszeń. Dane przesyłane są wyłącznie w celu pobrania treści ogłoszeń i nie są wykorzystywane do innych celów.

License

Motendo Widget jest dystrybuowany na licencji GPLv2 lub nowszej. Aby uzyskać więcej informacji, odwiedź https://www.gnu.org/licenses/gpl-2.0.html.

屏幕截图

  • Ustawienia wtyczki w panelu administracyjnym.
  • Wyświetlanie ogłoszeń w treści wpisu.

安装

  1. Pobierz plik ZIP z wtyczką i rozpakuj go.
  2. Wgraj folder motendo-widget do katalogu /wp-content/plugins/.
  3. W panelu administracyjnym WordPress przejdź do sekcji Wtyczki i aktywuj wtyczkę “Motendo Widget”.
  4. Skonfiguruj ustawienia wtyczki w menu Ustawienia > Motendo Widget.

常见问题

Jak używać shortcode?

Wstaw następujący shortcode w treści wpisu lub strony:
[motendo_widget source=”latesearch” limit=”3″ phrase=”rolnicze” lang=”pl” format=”json”]

Parametry shortcode:
* source (domyślnie latesearch) – Źródło danych:
latesearch – Szukanie na podstawie frazy.
latest – Ostatnie ogłoszenia.
* limit (domyślnie 3) – Liczba ogłoszeń do wyświetlenia.
* phrase (domyślnie pusty) – Fraza wyszukiwania. Jeśli pusta, używane są tagi wpisu (tylko dla latesearch).
* lang (domyślnie pl) – Język ogłoszeń. Dostępne opcje: pl, en, de, ua.
* format (domyślnie json) – Format wyświetlania:
json – Widget generowany dynamicznie z danych JSON.
html – Wyświetlenie widgetu w iframe.
* user_id (opcjonalnie) – ID użytkownika, dla którego mają być pobierane spersonalizowane dane.

Jak automatycznie wstawić widget pod każdym wpisem?

Przejdź do Ustawienia > Motendo Widget i włącz opcję “Wyświetl pod każdym postem”.

Czy mogę wyświetlić widget w sidebarze?

Tak, wtyczka zawiera widżet o nazwie “Motendo Widget”, który można dodać do sidebara w panelu Wygląd > Widgety.

评价

此插件暂无评价。

贡献者及开发者

「Motendo Widget」是开源软件。 以下人员对此插件做出了贡献。

贡献者

帮助将「Motendo Widget」翻译成简体中文。

对开发感兴趣吗?

您可以浏览代码,查看SVN仓库,或通过RSS订阅开发日志

更新日志

1.2

  • Przepisana architektura wtyczki na model obiektowy z zastosowaniem przestrzeni nazw.
  • Wdrożono mechanizm cache’owania wyników zapytań do API przy użyciu transients.
  • Zmodyfikowano budowanie URL do API z użyciem http_build_query().
  • Rozdzielono logikę generowania HTML od logiki biznesowej przy pomocy output buffering.
  • Dodano filtry i hooki umożliwiające rozszerzenie funkcjonalności (np. motendo_widget_output, motendo_widget_transient_expiration).
  • Ulepszono panel ustawień w panelu administracyjnym oraz widżet, w tym lepszą obsługę błędów API i timeoutu zapytań.
  • Zaktualizowano obsługę parametru user_id.
  • Domyślny obraz (blank.jpg) jest teraz dołączony lokalnie (w katalogu assets/img/), aby wyeliminować zewnętrzne zależności.

1.1

  • Dodano obsługę parametru user_id w API.
  • Poprawiono funkcję automatycznego wstawiania widgetu pod każdym postem.
  • Rozbudowano ustawienia w panelu administracyjnym.

1.0

  • Pierwsze wydanie wtyczki.
  • Obsługa shortcode oraz widżetu.
  • Wyświetlanie ogłoszeń na podstawie frazy lub tagów.