Токени и Действия | Tokens and Actions

Токени връщат стойност и се изпълняват навсякъде — включително в заглавие, keywords и alt. Actions връщат разметка и се изпълняват само в съдържателни полета: тяло, анонс, excerpt, description.

Записите по-долу са с интервали вътре в скобите, за да не се изпълнят. При употреба интервалите се махат.

Токени

• { year } — текущата година
• { next_year } — текущата година + 1
• { previous_year } — текущата година - 1
• { site:X } — поле на сайта. X е name, url, domain, phone, email или address
• { page:X } — поле на страницата. X е id, n, name, title, url, description, meta_title, meta_description или image
• { var:ИМЕ } — стойност от PHPvars или от регистъра
• { site_name } — име на сайта
• { site_email } — e-mail на сайта
• { site_phone } — телефон; по избор приема ключ на друго поле
• { page_title } — заглавие на страницата
• { page_name } — име на страницата
• { pageurl } — включва legacy файла на страницата

Стар правопис на токен

Работят навсякъде, както и каноничните.

• [ current_year ] = { year }
• [ next_year ] = { next_year }
• [ previous_year ] = { previous_year }
• [ site_name ] = { site:name }
• [ site_url ] = { site:url }
• [ site_phone ] = { site:phone }
• [ site_email ] = { site:email }
• [ page_title ] = { page:title }
• [ page_name ] = { page:name }
• [ page_url ] = { page:url }

Внимание: записът е точен, без интервали и без нищо друго в скобите. Грешното [ current_year - next_year ] излиза буквално на страницата. Правилното е [ current_year ] - [ next_year ], като два отделни записа.

Анкети actions 

[ poll_choosen ] анкетата на страницата, както досега
[ poll_choosen ankID=31 ] коя да е анкета
[ poll_last_voted field=title ] заглавие на последно гласуваната
[ poll_last_voted field=url ] линк към резултатите
[ poll_last_voted field=answer ] за кой отговор е гласувано

Календарни actions

• [ calendar_type ] — type, month, year, shift, country
• [ calendar_combined ] — month, year, shift, country
• [ print_calendar ] — month, shift
• [ print_easter ] — shift, format
• [ country_codes ] — без параметри
• [ datetime ] — format

Стойности на type: 1 национални, 2 църковни (по подразбиране), 3 имени дни, 4 професионални, 5 данъчен, 6 официални.

Стойности на shift: 0 текуща година, 1 следваща година.

По подразбиране: type е 2, month и year са текущите, shift е 0, country е bg.

Пример: [ calendar_type month=5 type=6 shift=1 ] дава официалните празници през май за следващата година.

Текст и оформление

Отбелязаните със звездичка имат отварящ и затварящ таг и обработват съдържанието между тях.

• [ button_link ] * — бутон-връзка. href, class, newTab
• [ page_link ] — връзка към страница по номер. n
• [ print_group ] * — рендерира подстраниците на група. id
• [ get_picture ] * — изображение на страницата. id, class, width, alt
• [ popup_image ] — модален лайтбокс за изображенията
• [ embed_pdf ] * — PDF, пътят е в съдържанието. width, height, class
• [ fa ] * — Font Awesome икона. type, size, pull, spin, rotate, flip, inverse, border, xclass
• [ row ] * — Bootstrap ред. class
• [ col ] * — Bootstrap колона. md
• [ code ] — обвива съдържанието в pre и code
• [ upper ] * — главни букви
• [ lower ] * — малки букви
• [ autoescape ] * — връща съдържанието необработено
• [ sequence ] * — повтаря съдържанието N пъти. times, separator
• [ pull_quote_shortcode ] — цитат. quote, attribution
• [ get_name ] — съединява двете стойности. first, last

Legacy PHP мостове

Изпълняват PHP от полетата на самата страница. Който има право да редактира текста, през тях получава и изпълнение на код.

• [ eval_php ] — изпълнява полето PHPcode на страницата
• [ dop ] — изпълнява PHPcode и включва файла от PageURL
• [ include_dop ] — включва файл. name

Bootstrap 3

52 компонента. Всички са обхващащи освен [ bs_table ]. Всички приемат xclass за допълнителни CSS класове и data за data-атрибути.

Оформление: [ bs_container ], [ bs_container_fluid ], [ bs_row ], [ bs_column ], [ bs_responsive ], [ bs_divider ], [ bs_well ], [ bs_page_header ], [ bs_jumbotron ]

Бутони и навигация: [ bs_button ], [ bs_button_group ], [ bs_button_toolbar ], [ bs_dropdown ], [ bs_dropdown_item ], [ bs_dropdown_header ], [ bs_caret ], [ bs_nav ], [ bs_nav_item ], [ bs_breadcrumb ], [ bs_breadcrumb_item ], [ bs_tabs ], [ bs_tab ]

Съдържание: [ bs_panel ], [ bs_alert ], [ bs_label ], [ bs_badge ], [ bs_icon ], [ bs_img ], [ bs_thumbnail ], [ bs_lead ], [ bs_emphasis ], [ bs_code ], [ bs_list_group ], [ bs_list_group_item ], [ bs_list_group_item_heading ], [ bs_list_group_item_text ], [ bs_media ], [ bs_media_object ], [ bs_media_body ], [ bs_table ], [ bs_table_wrap ], [ bs_progress ], [ bs_progress_bar ]

Интерактивни: [ bs_modal ], [ bs_modal_footer ], [ bs_carousel ], [ bs_carousel_item ], [ bs_collapse ], [ bs_collapsibles ], [ bs_tooltip ], [ bs_popover ], [ bs_embed_responsive ]

Feature пакети

Зареждат се за конкретен сайт през настройката initPHP.

• [ weather_t ] — максимална температура за деня
• [ poll_choosen ] — резултат от анкета
• [ bartag ] — тестов пример

Къде се декларират

• Токени — shortcodes/main/tokens_common.php
• { pageurl } — engine/app/extensions/LegacyPageUrlExtension.php
• Стар правопис — lib/lib_page.php, таблица с alias-и
• Календарни, текст и оформление — shortcodes/main/shortcodes.php
• Bootstrap 3 — shortcodes/main/bootstrap3.php
• Feature пакети — shortcodes/poll, shortcodes/wwo, shortcodes/ticksys

Как се пише пример, без да се изпълни

Слага се интервал вътре в скобите, от двете страни. Работи и за къдрави, и за квадратни.

Определящ е интервалът след отварящата скоба. Само отзад не пази: записът [ calendar_type month=1 ] без първия интервал се изпълнява, защото зоната на атрибутите допуска интервали.

Удвояването на скобите не е надежден начин. За квадратен action работи, но за токен и за стар правопис не работи — удвоените къдрави скоби връщат стойността в скоби, а удвоеният стар правопис също се изпълнява, защото преводът към каноничен запис се случва преди обработката на екранирането.