Страница 4 из 5

Re: Дискуссия: Расширения и документация yii

Добавлено: 2010.07.22, 14:14
samdark
Ну да.

Re: Дискуссия: Расширения и документация yii

Добавлено: 2010.08.18, 10:46
yii
Не знаю куда писать, поэтому пишу здесь.
на странице http://www.yiiframework.com/doc/api/CDbCriteria

в списке Public Properties не хватает свойства on

нашел описание здесь http://yiiframework.ru/doc/guide/ru/database.arr:

Код: Выделить всё

on: соответствует оператору ON. Условие, указываемое в этом параметре, будет добавлено к условию объединения с использованием оператора AND. Для используемых столбцов должны быть разрешены конфликты имён. Данный параметр неприменим для отношений типа MANY_MANY. Параметр доступен, начиная с версии 1.0.2; 
может кому пригодится, если не поправят API ;)

Re: Дискуссия: Расширения и документация yii

Добавлено: 2010.08.18, 11:36
samdark
Вообще его в CDbCriteria и нет. Это свойство относится к CActiveRecordRelation.

Re: Дискуссия: Расширения и документация yii

Добавлено: 2010.09.07, 11:05
BuCeFaL
RuZk писал(а):В документации очень не хватает примеров задания различных отношений AR, например как связать 2 таблицы посредством третей (я пока так и не понял, возможно ли это вообще сделать (viewtopic.php?f=3&t=1089 дополнительный вопрос в 3 посте))
Есть больше одного способа сделать это.
1) таблица посредник с 2-мя отношениями (левое и правое)
2) отношение у отношения

Код: Выделить всё

//...
            $criteria->with = array(
            'category',
            'translation',
            'translation_en',
            'anyRelation'=>array('with' => array('parent'))
            );
//...
            $criteria->with = array(
            'category',
            'translation',
            'translation_en',
            'anyRelation.parent'
            );
//...
 
А вообще огромное спасибо за документацию.

Re: Дискуссия: Расширения и документация yii

Добавлено: 2010.09.13, 14:17
Dr0ID
В документации очень часто забвают о мелочах. Например вот -- http://www.yiiframework.com/forum/index ... n-buttons/ , потратил наверное полчаса на гугление данного вопроса. Может в документации лучше приводить полные примеры, со всеми опциями и тд?

Re: Дискуссия: Расширения и документация yii

Добавлено: 2011.03.17, 20:37
uksus
Dr0ID писал(а):В документации очень часто забвают о мелочах. Например вот -- http://www.yiiframework.com/forum/index ... n-buttons/ , потратил наверное полчаса на гугление данного вопроса. Может в документации лучше приводить полные примеры, со всеми опциями и тд?
да. я тоже над каждой мелочью сижу подолгу. не так и легко "войти" в фреймворк. отсутствие примеров очень напрягает.
но я так понимаю, это из-за нехватки человеческих ресурсов.
сейчас пытаюсь после штудирования как-то конспектировать и делать заметки к api

Якоря в документации

Добавлено: 2011.08.13, 08:42
esche
SamDark, возможно, имеет смысл добавить на страницы русскоязычной документации якоря. Будет удобнее и ссылку дающему и адресату. (в сравнении с http://... "Раздел такой-то".) Если в результате обсуждений или технических сложностей данный вариант уже был отклонён - приношу извинения

ps. со своей стороны готов оказать помощь в подборе|вставке якорей
pps. для автогенерации (если возможно) можно пользовать транслит или "а-ля википедия" #.D0.A7.D0...

Re: Якоря в документации

Добавлено: 2011.08.13, 20:04
rak
esche писал(а):SamDark, возможно, имеет смысл добавить на страницы русскоязычной документации якоря. Будет удобнее и ссылку дающему и адресату. (в сравнении с http://... "Раздел такой-то".) Если в результате обсуждений или технических сложностей данный вариант уже был отклонён - приношу извинения

ps. со своей стороны готов оказать помощь в подборе|вставке якорей
pps. для автогенерации (если возможно) можно пользовать транслит или "а-ля википедия" #.D0.A7.D0...
поддерживаю, c якорями намного удобнее было б

Re: Дискуссия: Расширения и документация yii

Добавлено: 2011.08.13, 20:56
TranceSmile
Если честно то половина документации очень заумно написана (или просто упущены какие-то мелочи). Я только позавчера капитально взялся его изучать (я бы может и отказался от него, но я уже давно знаю SamDark-a я думаю за гнилой проект он бы не брался).

Re: Дискуссия: Расширения и документация yii

Добавлено: 2011.08.13, 21:25
samdark
esche, rak, якоря прикручу.

TranceSmile, стоит собрать список таких непонятных мест или мест с излишне заумными формулировками и отметить, что именно непонятно. Возможно, поможет улучшить документацию.

Re: Дискуссия: Расширения и документация yii

Добавлено: 2011.08.13, 21:34
greatdane
Да просто примеров надо больше в документации. Особенно в английском API. Тогда сразу документация перестанет казаться сухой и заумной...

Re: Дискуссия: Расширения и документация yii

Добавлено: 2011.08.13, 21:39
samdark
Конкретику надо. А лучше сами примеры. С радостью добавлю.

Re: Дискуссия: Расширения и документация yii

Добавлено: 2011.08.13, 21:43
greatdane
К тому времени, как до меня доходит, как что-то сделать — мне уже пофиг, есть пример в документации или нет... ну просто ко всему нужны примеры для новичка. К валидаторам, к виджетам, к CHtml...

Re: Дискуссия: Расширения и документация yii

Добавлено: 2011.12.28, 18:00
f0t0n
greatdane писал(а):К тому времени, как до меня доходит, как что-то сделать — мне уже пофиг, есть пример в документации или нет...
+1 xD
greatdane писал(а):ну просто ко всему нужны примеры для новичка. К валидаторам, к виджетам, к CHtml...
... к COutputCache

По поводу расширений я считаю, что можно "зарегистрировать" в Yii подкоманду опытных разработчиков, которым интересна разработка расширений и которая будет производить ревизию пользовательских расширений и принимать решения о добавлении их к "официальной коллекции" либо давать рекомендации автору по исправлению/улучшению, а также писать и развивать свои расширения "на наиболее популярные темы".
Т.е. сторонние авторы расширений могли бы и дальше сваливать их в общую кучу или, если это - что-то стоящее, регистрировать свое расширение для ревизии и возможного утверждения.

Re: Дискуссия: Расширения и документация yii

Добавлено: 2011.12.28, 18:19
samdark
Примерно такая команда у нас в yiiext https://github.com/yiiext. Единственное — нет официального статуса…

Re: Дискуссия: Расширения и документация yii

Добавлено: 2012.07.05, 09:09
folly
Добрый день.
Разбираюсь с yii с понедельника, чайнику от документации мало пользы: куски кода и непонятно, как их использовать.
Количество вопросов после чтения этой документации только увеличивается.
Если бы был пример, как вставить приведенный код в метод xxx класса yyy итп и где он может применяться (в модели, в контроллере итп), было бы здорово.

Вероятно, в документацию следует добавить FAQ , а потом доработать ее с учетом вопросов, возникающих у начинающих.

Re: Дискуссия: Расширения и документация yii

Добавлено: 2012.07.05, 19:12
samdark
http://yiiframework.ru/doc/guide/ru/bas ... -practices разве не отвечает на вопрос, где и что использовать?

Re: Дискуссия: Расширения и документация yii

Добавлено: 2012.09.24, 17:52
aser
Что бы начать работать с Yii достаточно пробежаться по документации, пройти тоториал, не скопипастить, а именно повторить. Не достающие куски всегда можно посмотреть в исходниках, которые идут вместе с дистрибутивом фреймворка.
Мне кажется что документация к фреймворку не должна превращаться в документацию по PHP или алгоритмам.

Вот пришлось спустя 4 года окунутся в CodeIgniter, вот там вот документация страдает.

Огромное спасибо команде Yii за поддержание документации и API в актуальном состоянии.

Re: Дискуссия: Расширения и документация yii

Добавлено: 2012.11.06, 10:14
tiron_alexey
aser писал(а):Огромное спасибо команде Yii за поддержание документации и API в актуальном состоянии.
+1
Документация в нормальном состоянии (по крайней мере сейчас мне достаточно, может дальше чет не будет хватать :) ). Иногда правда все таки не хватает примеров, для того, чтобы быстрее разобраться, но соглашусь с aser - "документация к фреймворку не должна превращаться в документацию по PHP или алгоритмам".

Re: Дискуссия: Расширения и документация yii

Добавлено: 2012.11.07, 14:43
Damange
Sam Dark писал(а): стоит собрать список таких непонятных мест или мест с излишне заумными формулировками и отметить, что именно непонятно. Возможно, поможет улучшить документацию.

Прочитал документацию. Выполнил демо пример. Заглядывал в API. Смотрел и разбирался в коде Юпи и ПламЦМФ.
После 2 суток общения с Yii сложились вопросы:

Active Records
1. Модели без AR. Да, в документации есть пример, но он какой-то жиденький.
2. Чего мы лишаемся, при НЕиспользовании AR?
3. Валидация, пагинация, zii-виджеты с dataProvider, кэширование для моделей без AR.
4. Как можно оптимизировать AR, кроме кэширования схемы.

Модели
5. Включить в официальную документацию расширенный пример с DAO (да он есть в рецептах, может что то добавить в основную документацию)
по мне, так более понятно описано в Laravel http://laravel.ru/docs/models#сущности, http://laravel.com/docs/models#best-practices
Различия между DAO и Entities - Services - Repositories: http://stackoverflow.com/questions/8550 ... y-patterns
6. Простые модели, а ля модели CodeIgniter. То есть когда есть построитель запросов, с помощью которого выполняются выборки и возврат результатов. 1 модель - 1 файл.
7. Было бы не плохо добавить в документацию или в рецепты более глобальный пример использования Yii без AR. Можно на примере базового демо-блога.

Общее
8. В документации используется просто Widget. В примере по демоблогу используется Yii::import('zii.widgets.CPortlet'). Вначале я думал что я читал невнимательно официальную документацию. Проверил поиском "CPortlet" - ничего не найдено. Зачем нужно делать Yii::import?


ps. Данные вопросы дублирую в ветке вопросов. Интересные ответы - верну сюда.