Компания Trellon недавно запустила цикл ознакомительных статей о том как пользоваться API популярных модулей Друпала (Views, CCK и так далее). Цикл называется "20 API за 20 дней", сейчас в нем пока статьи про 4 API, но скоро, видимо, будет 20.
Статьи показались мне неплохими, так что я их решил переводить. Переводы публикую у себя в блоге под тегом "20 API за 20 дней". Пока перевел вступление со списком запланированных API и первую статью (про CCK). Дальше будет больше, если интересно - заходите.
Комментарии
Супер. Подписался на тег "друпальчики" по rss. Спасибо за переводы!
http://graker.ru/news/2010/03/21/select_box_s_podzagolovkami - у вас есть просто замечательные записи, вы тут это публиковали? крайне интересно.
2 adubovskoy: не, про селект боксы нигде не публиковал, мне оно не показалось значительным.
2 Ламер: ну да, пехепе надо изучать.
Вот это я бы на главную отправил
Подписался на RSS.
subsc., thanks
Инициатива более, чем похвальная.
Кстати, о CCK мы уже писали похожее как-то раз — http://shvetsgroup.com/ru/blog/custom-cck-2-field
Очень хорошее дело ты задумал! Спасибо.
После перевода надо будет занести статьи в подшивку документации в обязательном порядке.
Ага, только надо со ссылками на оригиналы треллонавтовских статей
И на твой блог тоже
На английском худо-бедно найти информацию можно, но на русском мало. Тем более в одном месте.
А ведь коммьюнити для этого и существуют!
добавил в закладки.. буду читать.
спасибо
Подписался на rss. Спасибо очень полезно буду следить.
Перевел вторую заметку цикла про API хуков Друпала.
Сначала меня насторожила статья про CCK, которая закончилась словами
я подумал,
ладно, веротяно кому то лень просто прочесть апи на api.drupal.org и ему проще увидеть это в такой вот неформальной форме пересказа...
но когда я прочитал статью о хуках
которая содержит ряд КОНЦЕПТУАЛЬНЫХ ошибок в описаниях хуков DRUPAL
я понял:
это переводить не только не нужно,а еще и вредно.
как пример - хуки друпала не привязаны к имени модуля. Да, такая привязка в некоторых "высокоуровневых" функциях друпала есть. Но это не правило.
За информацией к размышлению -> описание хуков работы с программно организованными типами материалов. Которые О УЖАС не привязаны к названию модуля, но тем не менее называются хуками etc...
жду фееричного продолжения
Я правильно понял, ряд состоит из одного пункта?
Базару нет. Нельзя ли фееричную цитату, где написано, что это правило?
Перевел третью статью (про Views API).
в любом месте описывающим хуки, написано - имя модуля.
а это не так. к имени модуля - это имеет отношение точно так же как ромб к паралелограмму.
первый является частным случаем последнего.
пример
и так далее.
весь материал написан таким образом что создает ложное впечатлние будто бы хуки привязаны к имени модуля.
Во-первых: в данном случае скорее наоборот - реализация хуков _insert, _update, _delete и еще нескольких в модуле node является исключением из правила, если уж вам угодно называть это правилом. Если же есть некое более общее правило, может быть, уже пора его привести вместе со ссылкой на документацию, где это правило указано?
Во-вторых: node_invoke - это workaround, созданный для того, чтобы разработчик не втыкал условные операторы в хуки, если у него создается несколько типов нод в одном модуле. О том, что это workaround говорит вся реализация, начиная с того, что в комментариях к hook_node_info() говорится "обычно сюда вставляют имя модуля" и заканчивая тем, что столбец в БД, в котором хранится префикс названия функции реализации хука прямо так и называется - имя модуля ('module'). Сделано это, я полагаю, специально, чтобы у пользователя не создалось впечатление о существовании неких более общих правил, нежели имямодуля_имяхука.
В третьих, не стоит забывать, что это обучающая статья, в которой необходимо дать читателю представление о хуках и том, как они обычно именуются, а не перечислять частные случаи, с которыми многие могут вообще не столкнуться. Кстати, в цикле была запланирована статья и про Node API, так что рассказать об обсуждаемой проблеме они могут и потом.
В четвертых, реализацию произвольного хука, вызываемого через module_invoke() или module_invoke_all(), иначе как с имени модуля у вас начать не получится, и это действительно правило.
Наконец, в пятых, если эта ошибка так фундаментальна, предлагаю начать ее исправление прямо со страницы API Hooks, потому что ее авторы явно с вами насчет правил не согласны. Цитата:
Перевел четвертую статью - про API форм.
Внезапно появилась пятая статья, про Token. Перевел.
Долго ли, коротко ли, но вышла шестая статья (про Feeds). Статья не ахти какая, но я ее все равно перевел.
Очень полезная статья, прочитал с удовольствием
Быстро ты.
Насчет полезности я иначе считаю. Цикл-то про API, поэтому хотелось бы больше о работе с API, а не общие слова. Но хорошо, значит я уже не зря переводил