Zasady działania niestandardowe hosting Drupal

Definiowanie reguł zgodnych działań.

Hak ten jest niezbędny, aby dodać nową akcję zasadami. Powinien on być umieszczony w pliku MODULENAME.rules.inc, który zostanie automatycznie włączone, gdy hak jest wywoływany.

wartość zwracana

Szereg informacji na temat zasad przewidzianych działań modułu. Tablica zawiera sub-array dla każdego działania, z nazwą działania jako klucz. Nazwy Operacje mogą zawierać tylko małe znaki alfanumeryczne i podkreślenia i powinna być poprzedzona przekazującą nazwę modułu. Możliwe atrybuty każdego sub-tablicy są następujące:

Zasady działania niestandardowe Drupal hosting tablica może zawierać następujące
  • etykieta. Etykieta działania. Rozpocznij kapitalizowane. Wymagany.
  • Grupa. Grupa dla tego elementu, używane do grupowania działań w interfejsie. Powinna rozpocząć się wielką literą i zostać przetłumaczone. Wymagany.
  • parametr. (Opcjonalnie) Tablica opisująca wszystkie parametry do działania z nazwy parametru jako klucza. Każdy parametr ma być opisany tablicy podrzędnej z możliwych cech opisane później, przy czym nazwa parametru musi być małe, ważne PHP Nazwa zmiennej.
  • przewiduje. (Opcjonalnie) Tablica opisująca zmienne działanie zapewnia do stanu oceniającą z nazwy zmiennej jako klucza. Każda zmienna musi być opisany tablicy podrzędnej z możliwych cech opisane później, przy czym nazwa parametru musi być małe, ważne PHP Nazwa zmiennej.
  • „Parametr o nazwie”. (Opcjonalnie) Jeżeli ustawione na TRUE, argumenty zostaną przekazane w postaci pojedynczej tablicy z nazwami parametrów jak klucze. Ten emuluje nazwane parametry w PHP i jest szczególnie przydatna, jeśli liczba parametrów może się zmieniać. Domyślne False.
  • baza. (Opcjonalnie) Podstawą callbacków realizacji działań mających na celu użyć zamiast nazwy wybranego działania. Domyślnie do nazwy działania.
  • wywołania zwrotne. (Opcjonalnie) tablicę, która pozwala na ustalenie konkretnych zwrotnych funkcyjnych do działania. Wartość domyślna dla każdego wywołania zwrotnego jest podstawą działania dołączone przez „_” i nazwą zwrotnego.
  • 'Callback dostępu'. (Opcja) zwrotna, która musi wrócić, czy aktualnie zalogowany użytkownik może skonfigurować tę czynność. Zobacz rules_node_integration_access () dla przykładowego zwrotnego.

Każdy „parametru” tablica może zawierać następujące właściwości:

  • etykieta. Etykieta parametru. Rozpocznij kapitalizowane. Wymagany.
  • rodzaj. Typ danych Zasady parametru, który ma być przekazany do działania. Wszystkie rodzaje zadeklarowane hook_rules_data_info () może być określony, a także szeregu możliwych typów. Także list i wykazów danego typu może być określony za pomocą listy notating wprowadzony przez moduł metadanych jednostki patrz hook_entity_property_info (). Specjalny keyword „*” mogą być stosowane, gdy wszystkie typy powinny być dozwolone. Wymagany.
  • wiązki. (Opcjonalnie) Tablica nazw pakietu. Gdy określony typ jest ustawiony na jednym rodzajem jednostki, może być wykorzystywane do ograniczania dozwolonych wiązek.
  • opis. (Opcjonalnie) W razie potrzeby, dalszy opis tego parametru.
  • lista opcji. (Opcja) zwrotna, która zwraca szereg możliwych wartości tego parametru. Wywołania zwrotnego musi zwrócić tablicę używanego przez hook_options_list (). Dla przykładowej implementacji zobaczyć rules_data_action_type_options ().
  • zapisać. (Opcjonalnie) Jeśli jest ustawiony na TRUE, parametr zostanie zapisany w przepisach, gdy ocena reguły kończy. To jest obsługiwana tylko dla savable typów danych. Jeśli akcja zwraca FAŁSZ, oszczędność jest pomijany.
  • opcjonalny. (Opcjonalnie) może być ustawiony na TRUE, gdy nie jest wymagany parametr.
  • 'domyślna wartość'. (Opcjonalnie) Wartość przejść do działania w przypadku, gdy parametr jest opcjonalne i nie jest określona wartość.
  • 'Allow null'. (Opcjonalnie) Zasady zwykle nie przechodzą wszystkie wartości NULL jako argumentu, ale przerwania oceny czy wartość null jest obecny. Jeśli jest ustawiony na TRUE, Reguły nie będzie przerwać i przejść przez wartość NULL. Domyślne False.
  • ograniczenie. (Opcjonalnie) Ograniczanie jak argument dla tego parametru mogą być świadczone. Obsługiwane wartości są „selektor” i „wejście”.
  • tryb domyślny. (Opcjonalnie) Dostosuj tryb domyślny dla zapewnienia wartość argumentu dla parametru. Obsługiwane wartości są „selektor” i „wejście”. Wartość domyślna zależy od wymaganego typu danych.
  • zdezynfekować. (Opcjonalnie) Umożliwia parametry typu „text”, aby domagać się już oczyszczone argument. Jeśli opcja jest włączona, każda wartość podaną przez użytkownika nie będą odkażane się, ale zamienniki stosowane przez oceniających wejściowych są także jako wartości pobranych z wybranych źródeł danych.
  • przetłumaczalny. (Opcjonalnie) Jeżeli ustawione na TRUE, pod warunkiem wartość argument parametrem jest tłumaczony przez tłumaczeniu i18n String. Ma to zastosowanie tylko dla parametrów tekstowych, czyli parametry typu „tekst”, „znak”, „lista„I” lista”. Domyślne False.
  • ui klasa. (Opcjonalnie) Umożliwia nadrzędne klasy interfejsu użytkownika, który jest wykorzystywany do generowania interfejsu konfiguracji parametru. Domyślnie do klasy UI określonego typu danych.
  • czyszczenia zwrotnego. (Opcja) wywołania zwrotnego oceniający wejściowe mogą wykorzystać do czyszczenia wstawione osłabieniu; na przykład ten jest wykorzystywany przez token oceniającego.
  • owinięty. (Opcjonalnie) Ustaw na TRUE w przypadku dane powinny być przekazywane zawinięte. Dotyczy to tylko zawinięty typy danych, na przykład podmiotów.
Zasady działania niestandardowe Drupal hosting tablicę

Każdy „stanowi” tablica może zawierać następujące właściwości:

  • etykieta. Etykieta zmiennej. Rozpocznij kapitalizowane. Wymagany.
  • rodzaj. Typ danych reguły zmiennej. Wszystkie typy zadeklarowane w hook_rules_data_info () może być określona. Rodzaje mogą być sparametryzowanego np węzeł typy lub lista są ważne.
  • zapisać. (Opcjonalnie) Jeśli jest ustawiony na TRUE, zmienna warunkiem jest zapisany w przepisach, gdy ocena reguły kończy. możliwe tylko dla savable typów danych. Domyślne False.

Moduł musi zapewnić realizację każdego działania, jest funkcją o nazwie, jak określono w „bazy” klucza lub zwrotnego wykonania. Wszystkie inne możliwe wywołania zwrotne są opcjonalne. Obsługiwane wywołania zwrotne akcji przez reguły są zdefiniowane i udokumentowane w RulesPluginImplInterface. Jednakże każdy moduł może przedłużyć wtyczki działania w oparciu o zdefiniowany za pomocą interfejsu hook_rules_plugin_info (). Wszystkie metody zdefiniowane w tych interfejsów mogą być przesłonięte przez realizację działania. Implementacje zwrotnego dla tych interfejsów może znajdować się w dowolnym określonym pliku w hook_rules_file_info ().

powiązane tematy

Haczyki Haczyki rules', które mogą być realizowane przez inne moduły w celu rozszerzenia zasad.

składki / Przepisy / rules.api.php. linia 137 Ten plik nie zawiera kod PHP roboczego; istnieje w celu zapewnienia dodatkowej dokumentacji doxygen jak również udokumentować haki w standardowy sposób Drupal.

Obejrzyj ten film!

Powiązane artykuły

Działania api drupal hostingDefiniowanie reguł zgodnych działań. Hak ten jest niezbędny, aby dodać nową akcję zasadami. Powinien on być umieszczony w pliku MODULENAME.rules.inc, który zostanie automatycznie włączone, gdy ...
Boolean Pole typu hosting DrupalZałączyć niestandardowych pól danych podmiotom Drupal. API umożliwia Pole Pola niestandardowe dane mają być dołączone do podmiotów Drupala i dba o przechowywanie, ładowanie, edycji i renderowania danych dziedzinie ....
Czy akcja ref tablica hosting wordpressWykonywanie funkcji uzależniony od konkretnego haka działania, podając argumenty w tablicy. Funkcja ta jest identyczna do_action. ale argumenty przekazywane do funkcji podpięty do $ tag są ...
Dodaj pole typu hosting DrupalDomyślnie art. Strony. strona blogu. i inne typy zawartości nie ma miejsca dla gości zostawić komentarz. Począwszy Drupal 8 Komentarz został jego własny typ pola. Oznacza to, że jest ...
Dodaj niestandardowej strony w Drupal hostingZadeklarować ścieżkę i jego opcji. Etap ten obejmuje tytuł strony, wymogi dostępu do strony i inne. W Drupal 7, trzeba było wdrożyć hook_menu (). W Drupal 8, stworzyć ...