core/doc/pl/Widgets.md

Rdzenne widżety

Niektóre z tych widżetów ma ograniczenia, które mogą ograniczać typ strony, na której można umieszczać widżet lub mogą wymagać logowania

• clock - wyświetla aktualny czas

  • args: military (1 or 0) - use 24 hour time as opposed to AM/PM
     
    

• profile - wyświetla boczny pasek profilu na stronach, które ładują profile (strony z pseudonimem w adresie URL)

• tagcloud - wyświetla tagcloud elementów strony

  • args: count - liczba elementów do jednoczesnego wyświetlenia (domyślnie 24)
     
    

• collections - selektor grupy prywatności dla aktualnie zalogowanego kanału

  • args: mode - może to być "conversation", "group" albo "abook" w zależności od modułu
     
    

• suggestions - sugestie znajomych dla aktualnie zalogowanego kanału

• follow - przedstawia pole tekstowe do śledzenia innego kanału

• notes - obszar prywatnych notatek dla aktualnie zalogowanego kanału, jeśli funkcja private_notes jest włączona

• savedsearch - wyszukiwanie sieci lub matrycy z zapisem - trzeba być zalogowanym i musi być włączona funkcjonalność savedsearch

• filer - wybór elementów pola ze strumienia sieci lub matrycy - musi się być zalogowanym

• archive - selektor zakresu dat dla stron sieci i kanałów

  • args: 'wall' - 1 or 0, ograniczenie do wpisów ściennych lub wpisów sieciowych/matrycowych (domyślnie)
     
    

• fullprofile - taki sam jak obecny profil

• categories - filtr kategorii (strona kanału)

• tagcloud_wall - tagcloud tylko dla strony kanału

  • args: 'limit' - ilość tagów do wyświetlenie (domyślnie 50)
     
    

• catcloud_wall - tagcloud dla kategorii stron kanału

  • args: 'limit' - liczba kategorii do wyświetlenia na jednej stronie (domyślnie 50)
     
    

• affinity - suwak powinowactwa na stronie sieciowej, trzeba być zalogowanym

• settings_menu - menu paska bocznego dla strony ustawień, trzeba być zalogowanym

• mailmenu - menu paska bocznego dla strony z prywatnymi wiadomościami, trzeba sie zalogować

• design_tools - menu narzędzi projektowych do tworzenia stron internetowych, trzeba sie zalogować

• findpeople - narzędzia do wyszukiwania innych kanałów

• photo_albums - wyświetla listę albumów ze zdjęciami aktualnego właściciela strony za pomocą menu wyboru

• vcard - mini pasek boczny profilu dla osoby, którą się jest zainteresowanym (właściciel strony, cokolwiek)

• dirsafemode - narzędzie do wyboru katalogu - tylko na stronach katalogów

• dirsort - narzędzie do wyboru katalogu - tylko na stronach katalogów

• dirtags - narzędzie katalogowe - tylko na stronach katalogów

• menu_preview - wyświetlanie podgląd menu - tylko na stronach edycji menu

• chatroom_list - lista czatów dla właściciela strony

• bookmarkedchats - lista zakładek do czatów zebranych na tej stronie dla obecnego obserwatora

• suggestedchats - "ciekawe" czaty wybrane dla obecnego obserwatora

• item - wyświetla pojedynczą stronę internetową zgodnie z argumentem mid lub title

  • args:
  • channel_id - kanał, do którego należy treść, domyślnie jest to profile_uid
  • mid - message_id strony do wyświetlenia (musi być to strona internetowa a nie element konersacji)
  • title - argument title w adresie URL strony internetowej (musi zawierać tutuł lub mid)
     
    

• photo - wyświetla pojedyncze zdjęcie

  • args:
  • url - adres URL zdjęcia, musu zawierać schemat http lub https
  • zrl - uwierzytelniony link zid
  • style - łańcuch stylu CSS
     
    

• cover_photo - wyświetla zdjęcie okładkowe dla wybranego kanału

  • args:
  • channel_id - zastosowany kanał, domyślnie jest to profile_uid
  • style - łańcuch stylu CSS (domyślnie jest dynamicznie ustawiane na szerokość regionu)
     
    

• photo_rand - wyświetla losowe zdjęcie z jednego z albumów fotograficznych. Honorowane są uprawnienie dostępu do zdjęć

  • args:
  • album - nazwa albumu (bardzo gorąco zalecane, jeśli ma się dużo zdjęć)
  • scale - zazwyczaj 0 (oryginalna wielkość), 1 (1024px), 2, (640px) lub 3 (320px)
  • style - łańcuch stylu CSS
  • channel_id - jeśli nie Twój
     
    

• random_block - wyświetlić losowy element blokowy z kolekcji narzędzi do projektowania stron internetowych. Honorowane są uprawnienia dostępu.

  • args:
  • contains - zwraca tylko bloki, które zawierają łańcuch cotains w nazwie bloku
  • channel_id - jeśłi nie Twój
     
    

• tasklist - podać listę zadań lub spraw do załatwienia dla aktualnie zalogowanego kanału.

  • args:
  • all - jeśłi nie 0, to wyświetla ukończone zadania.
     
    

• forums - podać listę połączonych forów publicznych z niewidocznymi liczbami dla aktualnie zalogowanego kanału.
   
  

• activity - podać listę autorów nieprzeczytanych treści sieciowych dla aktualnie zalogowanego kanału.

• album - udostępnia widget zawierający pełny album ze zdjęciami z albumów należących do właściciela strony; może być zbyt duży, aby wyświetlić go w regionie paska bocznego, więc najlepiej jest zaimplementować to jako widżet obszaru treści.

  • args:
  • album - nazwa albumu
  • title - opcjonalny tytuł, używana jest nazwa albumu, jeśli nie jest dostęþna
     
    

Tworzenie własnych widżetów

Widżety oparty na klasie

Aby utworzyć widżet oparty, na przykład, na klasie o nazwie "slugfish", utwórz plik o następującej zawartości:

<?php

namespace Zotlabs\Widget;


class Slugfish {

	function widget($args) {

	... Wstaw tutaj kod widżetu.
	... Funkcja ta zwraca łańcuch, który jest treścią HTML widżetu.
	... $args to nazwa tablicy, która przekazuje sowolne zmienne [var] z edytora układu
	... Na przykład [widget=slugfish][var=count]3[/var][/widget] wypełni $args tak:
	... [ 'count' => 3 ]

	}

Wynikowy plik można umieścić w widget/Slugfish/Slugfish.php lub Zotlabs/SiteWidgets/Slugfish.php. Można go również połączyć z repozytorium git za pomocą pliku util/add_widget_repo.

Tradycyjny widget oparty na funkcjach

Jeśli chcesz mieć widżet o nazwie, na przykład, "slugfish", utwórz widget/widget_slugfish.php zawierający

<?php

function widget_slugfish($args) {

.. wstaw tu kod widżetu. Zobacz powyższe informacje o widżetach opartych na klasie, aby uzyskać szczegółowe informacje.

}

#include doc/macros/main_footer.bb;