|
Фреймворк Joomla поддерживает 21 стандартных типов параметров, которые можно применять в шаблонах, компонентах, модулях и других дополнений к Joomla. В этом разделе мы рассмотрим каждый тип параметра с кратким описанием.
calendar – обеспечивает поле ввода даты. Значок рядом с текстовым полем обеспечивает выплывающий календарь, который также может использоваться, чтобы ввести дату. Если у параметра уже есть сохраненное значение, то оно выводится в текстовом поле. Иначе, выводится значение по умолчанию.
type(обязательный) – должен быть со значение calendar;
- name(обязательный) – уникальное имя параметра;
- label(обязательный, переводимый) – заголовок поля;
- default(дополнительный) – дата, заданная по умолчанию;
- description(дополнительный, переводимый) – текст, выводимый как подсказка, когда пользователь перемещает мышь по текстовому полю;
- format(дополнительный) – формат вводимой даты. Стандартный формат даты PHP. Если никакой формат не задан, то выводится в формате '%Y-%m-%d', что соответствует ‘2009-10-14’;
- class(дополнительный) – имя класса CSS для поля HTML формы. Значение по умолчанию ‘inputbox’.
Пример XML-параметра:
<param name="mycalendar" type="calendar" default="5-10-2008" label="Select a date" description="" format="%d-%m-%Y" />
Поле формата определяет, в каком виде будет сохранена дата. Можно также вручную ввести дату, за исключением того, что дата была введена неправильно. Полное изложение всех форматов дат в PHP выложены на следующей странице: http://www.php.net/manual/en/function.date.php . Следующие форматы наиболее часто употребляются:
|
Символ
|
Описание
|
Пример
|
|
d
|
Число месяца, две цифры с начальными нулями.
|
От 01 до 31
|
|
D
|
День недели, три символа
|
С ‘Mon’ по ’Sun’
|
|
j
|
Число месяца, без начального нуля
|
С 1 по 31
|
|
I
|
Полная текстовая интерпретация дня недели
|
C ‘Monday’ по ‘Sunday’
|
|
N
|
Числовая интерпретация дня недели в стандарте ISO-8601 (поддерживается только в PHP 5.1.0 и выше)
|
С 1 (понедельник) по 7 (воскресенье)
|
|
S
|
Английский суффикс дня месяца, два символа
|
st, nd, rd, th. Выполняется с j
|
|
w
|
Числовая интерпретация дня недели
|
От 0 (понедельник) до 6 (воскресенье)
|
|
z
|
День года, начинается с нуля
|
От 0 до 365
|
|
W
|
Неделя в году в интерпретации стандарта ISO-8601, нумерация начинается с понедельника
|
42 (42-ая неделя в году)
|
|
F
|
Полная интерпретация названия месяца
|
С ‘January’ по ‘December’
|
|
m
|
Числовая интерпретация месяца, начинается с нуля
|
C 01 по 12
|
|
M
|
Краткая интерпретация названия месяца, в трех символах
|
С ‘Jan’ по ‘Dec’
|
|
n
|
Краткая интерпретация месяца, без начального нуля
|
С 1 по 12
|
|
t
|
Число дней в месяце
|
С 28 по 31
|
|
o
|
Год по стандарту ISO-8601.
|
1999 или 2003
|
|
Y
|
Полная числовая интерпретация года, 4 числа
|
1999 или 2003
|
|
y
|
Двухзначная интерпретация числа
|
99 или 03
|
|
a
|
В нижнем регистре до полудня и после полудня
|
am или pm
|
|
A
|
В верхнем регистре до полудня и после полудня
|
AM или PM
|
Примечание: календарный тип параметра не поддерживает негригорианские календари.
Перевод оригинальной статьи с английского: http://docs.joomla.org/Calendar_parameter_type |