Как известно, новые модули для Друпала появляются практически каждый день. Я задумал еженедельную рубрику "Новые модули Drupal за неделю", в которой будут перечисляться с небольшой (а иногда и большой) аннотацией модули, появившиеся на свет за прошедшие 7 дней. Сейчас рассматриваю только модули для Друпала 6.x, а дальше будет видно. Публикацию каждого выпуска планирую делать по воскресеньям.

В подборке опираюсь не на новости Drupal.org, а на страницу New Modules сайта Drupalmodules.com. Там новый модуль считается вышедшим, когда для него уже есть релиз (хотя бы dev). Поэтому в первый выпуск не вошел, к примеру, появившийся на Drupal.org сегодня многообещающий модуль Patch manager - релиза еще нет.

Пока не знаю, насколько это все интересно общественности. Но лично мне - интересно. Так что посмотрю, как пойдут пробные выпуски, если нормально - буду выпускать каждую неделю.

Ну а на этой неделе вышло 16 модулей: Nitobe Masthead Image, User backreference, SwiftRiver, DB Tuner, Language Switcher Dropdown, 443 Session, Brainstorm blogger update utility, Views tree, Filter Check, Taxonomy Menu Trails, JW Player Module for Drupal, Save Draft, Facebook Share, UC Product Dependencies, DrupalGapps: Google Apps framework for Drupal и Profile pictures.

Под катом - описания модулей.

Перевел первую статью цикла "20 API за 20 дней". Называется "Using CCK to Create New Field Types", автор - Майкл Хаггерти. В статье на примере модуля Email рассказывается, как добавить, сохранить в БД, оформить и темизировать свое поле CCK.

Перевод под катом.

На днях компания Trellon, занимающаяся разработкой сайтов на Друпале, объявила о начале цикла обучающих заметок «20 API за 20 дней». В них пойдет речь о том, как работать с API популярных модулей, такими как CCK API, Views API, Form API и так далее.

На данный момент вышло уже три заметки — про Views, про CCK и про Hook API. Ознакомившись, решил, что заметки хорошие и поэтому их необходимо перевести, чтобы русскоязычная общественность могла ознакомиться. Переводы будут публиковаться здесь же, под тегом «20 API за 20 дней». Ну и чтобы два раза не вставать — под катом перевод вступления к циклу. В нем рассказывается о том, какие умные и красивые ребята работают в Trellon, а также приводится список 20 API, которые будут рассмотрены. Автор — Майкл Хаггерти.

А переводы следующих заметок цикла — уже скоро!

Не все знают, но в Друпале элемент формы Select (выпадающий список) поддерживает группировку опций по подзаголовкам (см. тег OPTGROUP). Причем всего-то надо собирать опции в массиве '#options' в подмассивы:

  t('Arabic') => array(
    'IBM864' => 'IBM864',
    'ISO-885–6' => 'ISO-885–6',
    'WINDOWS-1256' => 'WINDOWS-1256',
  ),
  t('Armenian') => array(
    'ARMSCII-8' => 'ARMSCII-8',
  ),
  t('Baltic') => array(
    'ISO-885–4' => 'ISO-885–4',
    'ISO-885–13' => 'ISO-885–13',
    'WINDOWS-1257' => 'WINDOWS-1257',
  ),
  t('Celtic') => array(
    'ISO-885–14' => 'ISO-885–14',
  ),
  t('Central European') => array(
    'IBM852' => 'IBM852',
    'ISO-885–2' => 'ISO-885–2',
    'MAC-CENTRALEUROPE' => 'MacCE',
    'WINDOWS-1250' => 'WINDOWS-1250',
  ),
  //и т.д.

Тогда получится так:

Было:	Стало:

Странно, однако, что в Form API об этом — ни слова.

На будущее сохраняю генератор краткого списка кодировок. Пригодится.
Улучшенная версия:

function _get_iconv_encodings() {
  return array(
    t('Arabic') => drupal_map_assoc(array(
      'IBM864',
      'ISO-885–6',
      'WINDOWS-1256',
    )),
    t('Armenian') => drupal_map_assoc(array(
      'ARMSCII-8',
    )),
    t('Baltic') => drupal_map_assoc(array(
      'ISO-885–4',
      'ISO-885–13',
      'WINDOWS-1257',
    )),
    t('Celtic') => drupal_map_assoc(array(
      'ISO-885–14',
    )),
    t('Central European') => drupal_map_assoc(array(
      'IBM852',
      'ISO-885–2',
      'MacCE',
      'WINDOWS-1250',
    )),
    t('Chinese Simplified') => drupal_map_assoc(array(
      'GB18030',
      'GB2312',
      'GBK',
      'ISO-2022-CN',
    )),
    t('Chinese Traditional') => drupal_map_assoc(array(
      'BIG5',
      'BIG5-HKSCS',
      'EUC-TW',
    )),
    t('Cyrillic') => drupal_map_assoc(array(
      'IBM855',
      'ISO-885–5',
      'ISO-IR-111',
      'KOI8-R',
      'MACCYRILLIC',
      'CP866',
      'KOI8-U',
      'MACUKRAINIAN',
      'Windows-1251',
    )),
    t('Greek') => drupal_map_assoc(array(
      'ISO-885–7',
      'WINDOWS-1253',
    )),
    t('Hebrew') => drupal_map_assoc(array(
      'IBM862',
      'ISO-885–8',
      'WINDOWS-1255',
    )),
    t('Japanese') => drupal_map_assoc(array(
      'EUC-JP',
      'ISO-2022-JP',
      'SHIFT_JIS',
    )),
    t('Korean') => drupal_map_assoc(array(
      'EUC-KR',
      'ISO-2022-KR',
      'JOHAB',
    )),
    t('Nordic') => drupal_map_assoc(array(
      'ISO-885–10',
    )),
    t('Romanian') => drupal_map_assoc(array(
      'ISO-885–16',
    )),
    t('South European') => drupal_map_assoc(array(
      'ISO-885–3',
    )),
    t('Thai') => drupal_map_assoc(array(
      'ISO-885–11',
      'TIS-620',
      'WINDOWS-874',
    )),
    t('Turkish') => drupal_map_assoc(array(
      'IBM857',
      'ISO-885–9',
      'WINDOWS-1254',
    )),
    t('Unicode') => drupal_map_assoc(array(
      'UTF16',
      'UTF16BE',
      'UTF16LE',
      'UTF32',
      'UTF32BE',
      'UTF32LE',
      'UTF8',
    )),
    t('Vietnamese') => drupal_map_assoc(array(
      'VISCII',
      'WINDOWS-1258',
    )),
    t('Western') => drupal_map_assoc(array(
      'IBM850',
      'ISO-885–1',
      'ISO-885–15',
      'WINDOWS-1252',
    )),
  );
}

Спасибо, bohart.

Добавлял я вчера с помощью модуля новую категорию в профиль пользователя. Через hook_user(). Выглядит примерно так:

function mymodule_user($op, &$edit, &$account, $category = NULL) {
  switch ($op) {
    case 'categories' :
      $categories = array();
      $categories[] = array('name' => 'new_category',
                            'title' => t('New category'),
                            'weight' => 10,);
      return $categories;
    case 'load' :
      $account->field_1 = 1;
      $account->field_2 = 2;
      $account->field_3 = 3;
      break;
    case 'view' :
      $account->content['new_category'] = array(
        '#type' => 'user_profile_category',
        '#title' => t('New category'),
      );
      $account->content['new_category']['field_1'] = array(
        '#type' => 'user_profile_item',
        '#title' => t('Field 1'),
        '#value' => $account->field_1,
      );
      $account->content['new_category']['field_2'] = array(
        '#type' => 'user_profile_item',
        '#title' => t('Field 2),
        '#value' => $account->field_2,
      );
      $account->content['new_category']['field_3'] = array(
        '#type' => 'user_profile_item',
        '#title' => t('Field 3'),
        '#value' => $account->field_3,
      );
      break;
  }
} //function mymodule_user

Ну то есть добавляю три поля и они немедленно появляются в профиле каждого пользователя. Но вот незадача — популярный модуль Panels, который хорош в том числе и для создания красивых профилей пользователей, не умеет автоматически находить рукотворные категории пользователей и засасывать их в панели. Даже родную категорию 'History' (которая в коде называется 'summary') не хочет ни в какую показывать в списке доступных категорий.

В общем думал я, думал. Искал в интернетах и не нашел волшебного модуля, подсказывающего Panels список запрограммированных категорий. Создал тему на Друпал.ру — тоже пока нет результата. Единственное решение, которое я смог придумать — это кастом-панель, в которую выводится результат php-кода, формирующего категорию:

$uid = arg(1);
$user = user_load($uid);
$content = user_build_content($user);
foreach ($content['new_category'] as $item) {
  if ($item['#type'] == 'user_profile_item') {
    print theme('user_profile_item',$item);
  }
}

На том пока и остановился.

Недавно писал о том, как подружить свои таблицы данных с модулем Views. Кроме всего прочего, в той заметке рассматривал создание виртуального поля percentage, вычисляемого из двух существующих полей, а также фильтрацию и сортировку выборки по этому виртуальному полю.

А сегодня столкнулся с тем, что сортировка выборки с помощью views_handler_sort_formula не работает в табличных представлениях. Оказывается, когда мы выводим вьюху в виде таблицы и хотим сортировать таблицу щелчком мыши на заголовок одного из столбцов (что очень удобно) — модуль Views не применяет sort-хэндлер, который был указан при создании поля.

Немного покопавшись в документации, выяснил, что почему-то механизм «click-sort», используемый для сортировки табличных представлений, реализован вообще не в sort-хэндлерах, а вовсе и в field-хэндлерах. Именно поэтому сортировка таблицы по столбцу percentage была невозможна: Views пытался добавить в запрос несуществующее поле вместо формулы. Не вдаваясь в причины именно такой реализации, исправим недочет по горячим следам.

Сортировкой таблицы управляет метод views_handler_field::click_sort($order), где $order — порядок сортировки (ASC/DESC, ага). Поскольку мы уже сделали для своего поля хэндлер mytest_handler_field_percentage, нужно просто добавить к этому классу переопределение метода click_sort():

function click_sort($order) {
  $this->query->add_orderby(NULL, NULL, $order, 'ROUND(testnode.int_count*100/testnode.int_total)');
}

Собственно, вот и все. Теперь поле percentage может быть полноценным членом табличного представления.

При разработке модулей для Drupal мы частенько создаем программно новые типы материалов (то есть нод). В процессе иногда возникает соблазн быстренько запрограммировать вывод какой-нибудь отсортированной коллекции этих материалов. Например, вывод нод-городов, отсортированных по алфавиту, или по древности, или сгруппированных по странам. Таких полезных коллекций может образоваться достаточно много и программно создавать каждую из них — не очень эффективно. Особенно если впоследствии нам захочется что-то поменять, объединить, или переделать. Гораздо аккуратнее — использовать модуль Views.

Вообще говоря, Views — один из краеугольных камней разработки на Drupal. Хотите помесячный архив нод? Views. Хотите вывести только заголовки и даты нод? Views. Хотите вывести ноды, сгруппированные по именам авторов? Views. Хотите получить список IP, с которых пользователь Василий заходил на сайт в течение Великого поста? Тоже Views. Один из самых популярных ответов на вопрос «Как в Друпале сделать…» — Views. Так что, чем быстрее разработчик подружится с этим прекрасным модулем — тем лучше.

Однако как только разработчик захочет получить с помощью Views коллекцию созданных им данных — например, из самодельной таблицы, сделанной для нового типа материала — он обнаружит, что Views еще не знает о его таблице. Так вот, раз и навсегда рассказать о своей таблице модулю Views — на мой взгляд, гораздо более правильное решение, чем программировать вручную все необходимые представления.

О том, как это сделать — под катом.

С Друпалом я познакомился примерно пять лет назад, практически случайно. И с тех пор время от времени с переменным успехом им пользуюсь. Интересуюсь в первую очередь технической стороной - программированием и разработкой модулей, установкой и настройкой всего в единое целое и всяким таким. Дизайнами интересуюсь меньше, так как до сих пор не обнаружил в себе на этот счет выдающихся способностей.

Так или иначе, все это время обучал себя сам. Поиск, рассылки, статьи, поиск, описания API, снова поиск, исходники и так далее. В общем-то, обычное дело, многие так обучаются. Однако, в подобном подходе отсутствует важная вещь - полнота и системность получаемых знаний. В результате можно изучить "до дыр" устройство той или иной части ядра, но при этом, к примеру, вообще ничего не знать про что-нибудь очевидное и важное, вроде CCK или Views.

Единственный известный мне способ устранения этого недостатка - вдумчивое чтение хороших книг на тему. Тем более, что какой-то уровень понимания уже есть, так что для усвоения новых систематизированных знаний подготовлена база. В общем, решил я приблизиться к друпальному просветлению с помощью книг. Заказал сразу две на Books.Ru. Сегодня пришли, свеженькие.

Та, что слева - издание 2009 года, известный труд Джона Вандюка. В нем подробно рассмотрены вопросы внутреннего устройства Друпала и программирования под него. А справа - новая книга "Drupal: создание и управление сайтом" 2010 года. В ней, напротив, Друпал рассматривается со стороны настройки набора модулей для разных целей и приводятся примеры практической реализации популярных use-case (интернет-магазин, wiki и т.п.). Так что книжки, по идее, должны неплохо друг друга дополнять.

Буду просветляться.

В апреле под Москвой состоится конференция любителей Drupal под названием DrupalCamp. Принял решение посетить. Так сказать, предаться беспробудному пьянству и безобразию на людей посмотреть и себя показать.

Так-то уже два года на конференции не ходил. Но про Друпал охота посмотреть и послушать. Надо ехать.

Чуть не забыл отметить. Еще вчера вечером, ближе к полуночи, вышел первый (нулевой) номер русскоязычного журнала "Друпалогия", посвященного, естественно, CMF Drupal. Скачать журнал можно в пригодном для распечатывания формате PDF с сайта: http://magazine.drupalogy.ru/magazine/00. Статьи интересные, любознательным - рекомендую.

Ваш покорный слуга отметился в этом журнале заметкой "Сохранение формы в Drupal с помощью AJAX", которая когда-то была опубликована и на домовой странице.