{"id":219253,"date":"2025-02-04T09:38:57","date_gmt":"2025-02-04T09:38:57","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/motendo-widget\/"},"modified":"2025-02-04T10:04:54","modified_gmt":"2025-02-04T10:04:54","slug":"motendo-widget","status":"publish","type":"plugin","link":"https:\/\/da.wordpress.org\/plugins\/motendo-widget\/","author":23206731,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.2","stable_tag":"1.2","tested":"6.7.5","requires":"5.0","requires_php":"7.4","requires_plugins":null,"header_name":"Motendo Widget","header_author":"D@ni3l Ajeto","header_description":"Wy\u015bwietla ostatnie og\u0142oszenia lub promowane elementy z Motendo.","assets_banners_color":"e46f70","last_updated":"2025-02-04 10:04:54","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":345,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.2":{"tag":"1.2","author":"danielajeto","date":"2025-02-04 10:04:54"}},"upgrade_notice":{"1.2":"<p>Aktualizacja do wersji 1.2 jest wysoce zalecana. Wersja ta wprowadza nowe funkcje, w tym mechanizm cache\u2019owania, now\u0105 architektur\u0119 obiektow\u0105, ulepszon\u0105 obs\u0142ug\u0119 b\u0142\u0119d\u00f3w oraz rozszerzone mo\u017cliwo\u015bci konfiguracyjne, co znacz\u0105co poprawia wydajno\u015b\u0107 i elastyczno\u015b\u0107 wtyczki.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.jpg":{"filename":"icon-128x128.jpg","revision":3234579,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":3234579,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3234579,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3234579,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3234579,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3234579,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"Ustawienia wtyczki w panelu administracyjnym.","2":"Wy\u015bwietlanie og\u0142osze\u0144 w tre\u015bci wpisu.","3":"Widget w sidebarze."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1118,237844,160443,80,162],"plugin_category":[43],"plugin_contributors":[237845],"plugin_business_model":[],"class_list":["post-219253","plugin","type-plugin","status-publish","hentry","plugin_tags-json","plugin_tags-motendo","plugin_tags-ogloszenia","plugin_tags-shortcode","plugin_tags-widget","plugin_category-customization","plugin_contributors-danielajeto","plugin_committers-danielajeto"],"banners":{"banner":"https:\/\/ps.w.org\/motendo-widget\/assets\/banner-772x250.png?rev=3234579","banner_2x":"https:\/\/ps.w.org\/motendo-widget\/assets\/banner-1544x500.jpg?rev=3234579","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/motendo-widget\/assets\/icon-128x128.jpg?rev=3234579","icon_2x":"https:\/\/ps.w.org\/motendo-widget\/assets\/icon-256x256.jpg?rev=3234579","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/motendo-widget\/assets\/screenshot-1.png?rev=3234579","caption":"Ustawienia wtyczki w panelu administracyjnym."},{"src":"https:\/\/ps.w.org\/motendo-widget\/assets\/screenshot-2.png?rev=3234579","caption":"Wy\u015bwietlanie og\u0142osze\u0144 w tre\u015bci wpisu."}],"raw_content":"<!--section=description-->\n<p>Motendo Widget to wtyczka WordPress umo\u017cliwiaj\u0105ca wy\u015bwietlanie og\u0142osze\u0144 z serwisu <a href=\"https:\/\/www.motendo.com\">Motendo.com<\/a>. Wersja 1.2 wprowadza szereg usprawnie\u0144, kt\u00f3re zwi\u0119kszaj\u0105 wydajno\u015b\u0107, bezpiecze\u0144stwo oraz elastyczno\u015b\u0107 rozwi\u0105zania. Nowe funkcjonalno\u015bci obejmuj\u0105:<\/p>\n\n<ul>\n<li><strong>Nowa architektura obiektowa i przestrze\u0144 nazw:<\/strong> Kod zosta\u0142 przepisany na model obiektowy, co poprawia organizacj\u0119 oraz zmniejsza ryzyko konflikt\u00f3w z innymi wtyczkami.<\/li>\n<li><strong>Mechanizm cache\u2019owania:<\/strong> Wyniki zapyta\u0144 do API s\u0105 przechowywane w transients, co zmniejsza liczb\u0119 zapyta\u0144 do zewn\u0119trznego serwisu i poprawia szybko\u015b\u0107 dzia\u0142ania.<\/li>\n<li><strong>Wykorzystanie http_build_query():<\/strong> Budowanie URL do API odbywa si\u0119 teraz za pomoc\u0105 funkcji http_build_query(), co zwi\u0119ksza czytelno\u015b\u0107 kodu i bezpiecze\u0144stwo przesy\u0142anych danych.<\/li>\n<li><strong>Output buffering oraz oddzielenie logiki prezentacji:<\/strong> Renderowanie HTML odbywa si\u0119 przy u\u017cyciu output buffering, co u\u0142atwia modyfikacj\u0119 szablon\u00f3w i wprowadzanie filtr\u00f3w.<\/li>\n<li><strong>Dodanie hook\u00f3w i filtr\u00f3w:<\/strong> Dzi\u0119ki nowym filtrom (np. <code>motendo_widget_output<\/code> czy <code>motendo_widget_transient_expiration<\/code>) deweloperzy mog\u0105 \u0142atwo rozszerza\u0107 funkcjonalno\u015b\u0107 wtyczki.<\/li>\n<li><strong>Ulepszony panel ustawie\u0144:<\/strong> Rozbudowano opcje konfiguracyjne w panelu administracyjnym, m.in. dodano mo\u017cliwo\u015b\u0107 konfiguracji cache\u2019owania i timeoutu zapyta\u0144.<\/li>\n<li><strong>Poprawiona obs\u0142uga b\u0142\u0119d\u00f3w API:<\/strong> Wtyczka lepiej radzi sobie z b\u0142\u0119dami zewn\u0119trznego API, wy\u015bwietlaj\u0105c przyjazne komunikaty u\u017cytkownikowi.<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<p>Ta wtyczka \u0142\u0105czy si\u0119 z zewn\u0119trznym API dostarczanym przez Motendo.com w celu pobierania danych og\u0142osze\u0144. Oto szczeg\u00f3\u0142y dotycz\u0105ce tej us\u0142ugi:<\/p>\n\n<ul>\n<li><p><strong>Adres API:<\/strong><br \/>\nWtyczka wykonuje zapytania do API pod adresem:<br \/>\n  https:\/\/www.motendo.com\/widget\/<\/p><\/li>\n<li><p><strong>Wysy\u0142ane parametry:<\/strong><br \/>\nW zapytaniu wysy\u0142ane s\u0105 nast\u0119puj\u0105ce parametry:<\/p>\n\n<ul>\n<li><code>source<\/code> \u2013 okre\u015bla rodzaj wyszukiwania (np. <code>latesearch<\/code> lub <code>latest<\/code>).<\/li>\n<li><code>limit<\/code> \u2013 liczba og\u0142osze\u0144 do wy\u015bwietlenia.<\/li>\n<li><code>lang<\/code> \u2013 j\u0119zyk og\u0142osze\u0144 (np. <code>pl<\/code>, <code>en<\/code>, <code>de<\/code>, <code>ua<\/code>).<\/li>\n<li><code>format<\/code> \u2013 format danych zwracanych przez API (<code>json<\/code> lub <code>html<\/code>).<\/li>\n<li><code>phrase<\/code> \u2013 fraza wyszukiwania (je\u015bli nie zostanie podana, wykorzystywane s\u0105 tagi wpisu).<\/li>\n<li><code>user_id<\/code> \u2013 opcjonalnie, identyfikator u\u017cytkownika dla pobierania spersonalizowanych danych.<\/li>\n<\/ul><\/li>\n<li><p><strong>Cel przesy\u0142anych danych:<\/strong><br \/>\nParametry te s\u0105 wykorzystywane do pobrania odpowiednich og\u0142osze\u0144, kt\u00f3re nast\u0119pnie s\u0105 prezentowane na stronie. \u017badne dane osobowe u\u017cytkownika nie s\u0105 zapisywane przez wtyczk\u0119; przesy\u0142ane dane s\u0142u\u017c\u0105 jedynie do okre\u015blenia tre\u015bci wy\u015bwietlanych og\u0142osze\u0144.<\/p><\/li>\n<li><p><strong>Linki do regulamin\u00f3w i polityki prywatno\u015bci:<\/strong><br \/>\nU\u017cytkownicy powinni by\u0107 \u015bwiadomi, \u017ce korzystanie z tej us\u0142ugi odbywa si\u0119 zgodnie z warunkami i polityk\u0105 prywatno\u015bci serwisu Motendo.com. Prosimy o zapoznanie si\u0119 z:<\/p>\n\n<ul>\n<li><a href=\"https:\/\/www.motendo.com\/regulamin\/\">Regulaminem Motendo.com<\/a> <\/li>\n<li><a href=\"https:\/\/www.motendo.com\/polityka-prywatnosci\/\">Polityk\u0105 prywatno\u015bci Motendo.com<\/a> <\/li>\n<\/ul><\/li>\n<li><p><strong>Us\u0142uga a dane u\u017cytkownika:<\/strong><br \/>\nPrzy ka\u017cdym \u0142adowaniu widgetu wykonywane jest zapytanie do API, co umo\u017cliwia dynamiczne pobieranie aktualnych og\u0142osze\u0144. Dane przesy\u0142ane s\u0105 wy\u0142\u0105cznie w celu pobrania tre\u015bci og\u0142osze\u0144 i nie s\u0105 wykorzystywane do innych cel\u00f3w.<\/p><\/li>\n<\/ul>\n\n<h3>License<\/h3>\n\n<p>Motendo Widget jest dystrybuowany na licencji GPLv2 lub nowszej. Aby uzyska\u0107 wi\u0119cej informacji, odwied\u017a <a href=\"https:\/\/www.gnu.org\/licenses\/gpl-2.0.html\">https:\/\/www.gnu.org\/licenses\/gpl-2.0.html<\/a>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Pobierz plik ZIP z wtyczk\u0105 i rozpakuj go.<\/li>\n<li>Wgraj folder <code>motendo-widget<\/code> do katalogu <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>W panelu administracyjnym WordPress przejd\u017a do sekcji <strong>Wtyczki<\/strong> i aktywuj wtyczk\u0119 \"Motendo Widget\".<\/li>\n<li>Skonfiguruj ustawienia wtyczki w menu <strong>Ustawienia &gt; Motendo Widget<\/strong>.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='jak%20u%C5%BCywa%C4%87%20shortcode%3F'><h3>Jak u\u017cywa\u0107 shortcode?<\/h3><\/dt>\n<dd><p>Wstaw nast\u0119puj\u0105cy shortcode w tre\u015bci wpisu lub strony:\n[motendo_widget source=\"latesearch\" limit=\"3\" phrase=\"rolnicze\" lang=\"pl\" format=\"json\"]<\/p>\n\n<p>Parametry shortcode:\n* <strong>source<\/strong> (domy\u015blnie <code>latesearch<\/code>) - \u0179r\u00f3d\u0142o danych:\n  - <code>latesearch<\/code> \u2013 Szukanie na podstawie frazy.\n  - <code>latest<\/code> \u2013 Ostatnie og\u0142oszenia.\n* <strong>limit<\/strong> (domy\u015blnie <code>3<\/code>) \u2013 Liczba og\u0142osze\u0144 do wy\u015bwietlenia.\n* <strong>phrase<\/strong> (domy\u015blnie pusty) \u2013 Fraza wyszukiwania. Je\u015bli pusta, u\u017cywane s\u0105 tagi wpisu (tylko dla <code>latesearch<\/code>).\n* <strong>lang<\/strong> (domy\u015blnie <code>pl<\/code>) \u2013 J\u0119zyk og\u0142osze\u0144. Dost\u0119pne opcje: <code>pl<\/code>, <code>en<\/code>, <code>de<\/code>, <code>ua<\/code>.\n* <strong>format<\/strong> (domy\u015blnie <code>json<\/code>) \u2013 Format wy\u015bwietlania:\n  - <code>json<\/code> \u2013 Widget generowany dynamicznie z danych JSON.\n  - <code>html<\/code> \u2013 Wy\u015bwietlenie widgetu w iframe.\n* <strong>user_id<\/strong> (opcjonalnie) \u2013 ID u\u017cytkownika, dla kt\u00f3rego maj\u0105 by\u0107 pobierane spersonalizowane dane.<\/p><\/dd>\n<dt id='jak%20automatycznie%20wstawi%C4%87%20widget%20pod%20ka%C5%BCdym%20wpisem%3F'><h3>Jak automatycznie wstawi\u0107 widget pod ka\u017cdym wpisem?<\/h3><\/dt>\n<dd><p>Przejd\u017a do <strong>Ustawienia &gt; Motendo Widget<\/strong> i w\u0142\u0105cz opcj\u0119 \"Wy\u015bwietl pod ka\u017cdym postem\".<\/p><\/dd>\n<dt id='czy%20mog%C4%99%20wy%C5%9Bwietli%C4%87%20widget%20w%20sidebarze%3F'><h3>Czy mog\u0119 wy\u015bwietli\u0107 widget w sidebarze?<\/h3><\/dt>\n<dd><p>Tak, wtyczka zawiera wid\u017cet o nazwie \"Motendo Widget\", kt\u00f3ry mo\u017cna doda\u0107 do sidebara w panelu <strong>Wygl\u0105d &gt; Widgety<\/strong>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2<\/h4>\n\n<ul>\n<li>Przepisana architektura wtyczki na model obiektowy z zastosowaniem przestrzeni nazw.<\/li>\n<li>Wdro\u017cono mechanizm cache\u2019owania wynik\u00f3w zapyta\u0144 do API przy u\u017cyciu transients.<\/li>\n<li>Zmodyfikowano budowanie URL do API z u\u017cyciem http_build_query().<\/li>\n<li>Rozdzielono logik\u0119 generowania HTML od logiki biznesowej przy pomocy output buffering.<\/li>\n<li>Dodano filtry i hooki umo\u017cliwiaj\u0105ce rozszerzenie funkcjonalno\u015bci (np. <code>motendo_widget_output<\/code>, <code>motendo_widget_transient_expiration<\/code>).<\/li>\n<li>Ulepszono panel ustawie\u0144 w panelu administracyjnym oraz wid\u017cet, w tym lepsz\u0105 obs\u0142ug\u0119 b\u0142\u0119d\u00f3w API i timeoutu zapyta\u0144.<\/li>\n<li>Zaktualizowano obs\u0142ug\u0119 parametru <code>user_id<\/code>.<\/li>\n<li>Domy\u015blny obraz (blank.jpg) jest teraz do\u0142\u0105czony lokalnie (w katalogu <code>assets\/img\/<\/code>), aby wyeliminowa\u0107 zewn\u0119trzne zale\u017cno\u015bci.<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Dodano obs\u0142ug\u0119 parametru <code>user_id<\/code> w API.<\/li>\n<li>Poprawiono funkcj\u0119 automatycznego wstawiania widgetu pod ka\u017cdym postem.<\/li>\n<li>Rozbudowano ustawienia w panelu administracyjnym.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Pierwsze wydanie wtyczki.<\/li>\n<li>Obs\u0142uga shortcode oraz wid\u017cetu.<\/li>\n<li>Wy\u015bwietlanie og\u0142osze\u0144 na podstawie frazy lub tag\u00f3w.<\/li>\n<\/ul>","raw_excerpt":"Motendo Widget pozwala wy\u015bwietla\u0107 og\u0142oszenia z serwisu Motendo.com w postach, stronach i sidebarze.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/219253","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=219253"}],"author":[{"embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/danielajeto"}],"wp:attachment":[{"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=219253"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=219253"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=219253"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=219253"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=219253"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/da.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=219253"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}