7 Корисних функцій drupal api які повинен знати кожен, drupal learning

У цій замітці ми розглянемо 7 функцій Drupal API які дуже допомагають при розробці сайтів на Drupal 7.

check_plain ($ text) - перекодовує спецсимволи в HTML суті.

Значення, що повертається: оброблена рядок для відображення як HTML.

Це може бути корисним для обробки всіляких даних, що надходять на сайт з різних джерел: призначений для користувача введення, імпорт даних з іншого сайту, твіттера і т.д.

t ($ string, array $ args = array (), array $ options = array ()) - переводить рядок на обраний користувачем мова.

$ String - рядок для перекладу
$ Args - асоціативний масив значень підстановлювальних шаблонів (placeholders)
$ Options - асоціативний масив додаткових опцій, містить дві можливі опції: langcode - явне вказівку коду мови на який потрібно перевести рядок, context - дозволяє задати контекст перекладу.

Значення, що повертається: перекладена рядок.

Приклад використання функції t ():

Буває три типи підстановлювальних шаблонів:

!name - значення підставляється без образботкі
@name - значення обробляється функцією check_plain, все HTML теги виерзаются.
% Name - значення обробляється функцією theme_placeholder (теж що check_plain, але результат загортається в тег )

format_plural ($ count, $ singular, $ plural, array $ args = array (), array $ options = array ()) - формує рядок містить кількісне значення.

$ Count - кількісне значення

$ Singular - рядок яка буде використана в разі якщо $ count == 1

$ Plural - рядок яка буде використана в разі якщо $ count> 1

$ Args - асоціативний масив значень підстановлювальних шаблонів (placeholders)

$ Options - теж що і в функції t ()

Значення, що повертається: Рядок перекладена за допомогою функції t (), в залежності від параметра $ count вибирається рядок яка буде використовуватися для перекладу.

drupal_get_title () - повертає поточне значення заголовка сторінки

Це може бути корисним в поєднанні з drupal_set_title () для обробки поточного заголовка і установки нового.

drupal_set_title ($ title = NULL, $ output = CHECK_PLAIN) - встановлює заголовок сторінки

$ Title - рядок яка буде використана як заголовок сторінки

$ Output - прапор який визначає чи буде $ title оброблений функцією check_plain ().

Значення, що повертається: Оновлений заголовок сторінки.

url ($ path = NULL, array $ options = array ()) - формує внутрішній або зовнішній URL

$ Path - внутрішній відносний або зовнішній абсолютний шлях

$ Options - асоціативний масив опцій:

query - масив переданих параметрів типу ключ / значення

fragment - якір елемента на сторінці

absolute - прапор (за замовчуванням FALSE) якщо встановлено в TRUE то url буде визначено як абсолютний.

alias - прапор (за замовчуванням FALSE) якщо встановлено в TRUE то шлях буде розцінений як алиас (при цьому не буде здійснений пошук аліаса в базі даних що прискорить роботу)

external - прапор, якщо утсановлен в TURE url буде розцінений як зовнішній.

language - мовної об'єкт визначає мову для пошуку аліаса вибраної мови

https - прапор, якщо встановлений в TRUE то шлях буде мати https протокол, якщо в FALSE то http.

base_url - значення для заміни стандартного базового шляху

prefix - мовної префікс шляху

Значення, що повертається: Сформований URL.

drupal_goto ($ path = '', array $ options = array (), $ http_response_code = 302) - виробляє редирект користувача на іншу сторінку.

$ Path - відносний або абсолютний шлях на який буде проведений редирект.

$ Options - список опцій як в функції url ()

$ Http_response_code - код статус код

Поділися з друзями: