diff --git a/README.md b/README.md
index 2fcfc43fde..9157cf0f5c 100644
--- a/README.md
+++ b/README.md
@@ -20,10 +20,10 @@ which is the latest stable release of Yii.
[](https://packagist.org/packages/yiisoft/yii2)
[](https://packagist.org/packages/yiisoft/yii2)
-[](http://travis-ci.org/yiisoft/yii2)
-[](http://hhvm.h4cc.de/package/yiisoft/yii2-dev)
-[](https://scrutinizer-ci.com/g/yiisoft/yii2/)
[](https://www.versioneye.com/php/yiisoft:yii2/dev-master)
+[](http://travis-ci.org/yiisoft/yii2)
+[](http://hhvm.h4cc.de/package/yiisoft/yii2-dev)
+[](https://scrutinizer-ci.com/g/yiisoft/yii2/)
[](https://scrutinizer-ci.com/g/yiisoft/yii2/)
[](https://codeclimate.com/github/yiisoft/yii2)
diff --git a/docs/guide-de/README.md b/docs/guide-de/README.md
index 56cd087174..ca8d6c02c2 100644
--- a/docs/guide-de/README.md
+++ b/docs/guide-de/README.md
@@ -24,7 +24,7 @@ Einstieg
* [Arbeiten mit Formularen](start-forms.md)
* [Arbeiten mit Datenbanken](start-databases.md)
* [Code generieren mit Gii](start-gii.md)
-* [Ausblick](start-looking-head.md)
+* [Ausblick](start-looking-ahead.md)
Application Struktur
diff --git a/docs/guide-es/README.md b/docs/guide-es/README.md
index 4aa7efce97..413f8df401 100644
--- a/docs/guide-es/README.md
+++ b/docs/guide-es/README.md
@@ -24,7 +24,7 @@ Primeros pasos
* [Trabajar con formularios](start-forms.md)
* [Trabajar con bases de datos](start-databases.md)
* [Generar códigos con Gii](start-gii.md)
-* [Adentrarse en Yii](start-looking-head.md)
+* [Adentrarse en Yii](start-looking-ahead.md)
Estructura de una aplicación
diff --git a/docs/guide-es/start-looking-head.md b/docs/guide-es/start-looking-ahead.md
similarity index 100%
rename from docs/guide-es/start-looking-head.md
rename to docs/guide-es/start-looking-ahead.md
diff --git a/docs/guide-es/structure-views.md b/docs/guide-es/structure-views.md
new file mode 100644
index 0000000000..e766bdd838
--- /dev/null
+++ b/docs/guide-es/structure-views.md
@@ -0,0 +1,660 @@
+Vistas
+======
+
+Las Vistas (views) son una parte de la arquitectura [MVC](http://es.wikipedia.org/wiki/Modelo%E2%80%93vista%E2%80%93controlador).
+Estas son el código responsable de presentar los datos al usuario final. En una aplicación Web, las vistas son usualmente creadas
+en términos de *templates* que son archivos PHP que contienen principalmente HTML y PHP.
+Son manejadas por el componente de la aplicación [[yii\web\View|view]], el cual provee métodos comúnmente utilizados
+para facilitar la composición y el renderizado de las mismas. Por simplicidad, a menudo las llamamos *templates* o *archivos de templates*.
+
+
+## Creando Vistas
+
+Como fue mencionado, una vista es simplemente un archivo PHP que mezcla código PHP y HTML. La siguiente es una vista
+que muestra un formulario de login. Como puedes ver, el código PHP utilizado es para generar contenido dinámico, como el
+título de la página y el formulario mismo, mientras que el código HTML organiza estos elementos en una página HTML mostrable.
+
+```php
+title = 'Login';
+?>
+
title) ?>
+
+
Por favor completa los siguientes campos para loguearte:
+
+
+ field($model, 'username') ?>
+ field($model, 'password')->passwordInput() ?>
+
+
+```
+
+Dentro de una vista, puedes acceder a la variable `$this` referida al [[yii\web\View|componente view]] que maneja
+y renderiza la vista actual.
+
+Además de `$this`, puede haber otras variables predefinidas en una vista, como `$form` y `$model` en el ejemplo
+anterior. Estas variables representan los datos que son *inyectados* a la vista desde el [controlador](structure-controllers.md)
+o algún otro objeto que dispara la [renderización de la vista](#rendering-views).
+
+> Tip: La lista de variables predefinidas están listadas en un bloque de comentario al principio de la vista así pueden ser
+ reconocidas por las IDEs. Esto es también una buena manera de documentar tus propias vistas.
+
+
+### Seguridad
+
+Al crear vistas que generan páginas HTML, es importante que codifiques (encode) y/o filtres los datos provenientes
+de los usuarios antes de mostrarlos. De otro modo, tu aplicación puede estar expuesta a
+ataques tipo [cross-site scripting](http://es.wikipedia.org/wiki/Cross-site_scripting).
+
+Para mostrar un texto plano, codifícalos previamente utilizando [[yii\helpers\Html::encode()]]. Por ejemplo, el siguiente código
+aplica una codificación del nombre de usuario antes de mostrarlo:
+
+```php
+
+
+
+ name) ?>
+
+```
+
+Para mostrar contenido HTML, utiliza [[yii\helpers\HtmlPurifier]] para filtrarlo antes. Por ejemplo, el siguiente
+código filtra el contenido del post antes de mostrarlo en pantalla:
+
+```php
+
+
+
+ text) ?>
+
+```
+
+> Tip: Aunque HTMLPurifier hace un excelente trabajo al hacer la salida más segura, no es rápido. Deberías considerar
+ utilizar [caching](caching-overview.md) al resultado de aplicar el filtro si tu aplicación requiere un gran desempeño (performance).
+
+
+### Organizando Vistas
+
+Así como en [controladores](structure-controllers.md) y [modelos](structure-models.md), existen convenciones para organizar las vistas.
+
+* Para vistas renderizadas por controladores, deberían colocarse en un directorio tipo `@app/views/ControllerID` por defecto,
+ donde `ControllerID` se refiere al [ID del controlador](structure-controllers.md#routes). Por ejemplo, si
+ la clase del controlador es `PostController`, el directorio sería `@app/views/post`; Si fuera `PostCommentController`,
+ el directorio sería `@app/views/post-comment`. En caso de que el controlador pertenezca a un módulo, el directorio
+ sería `views/ControllerID` bajo el [[yii\base\Module::basePath|directorio del módulo]].
+* Para vistas renderizadas por un [widget](structure-widgets.md), deberían ser puestas en un directorio tipo `WidgetPath/views` por defecto,
+ donde `WidgetPath` se refiere al directorio que contiene a la clase del widget.
+* Para vistas renderizadas por otros objetos, se recomienda seguir una convención similar a la utilizada con los widgets.
+
+Puedes personalizar estos directorios por defecto sobrescribiendo el método [[yii\base\ViewContextInterface::getViewPath()]]
+en el controlador o widget necesario.
+
+
+## Renderizando Vistas
+
+Puedes renderizar vistas desde [controllers](structure-controllers.md), [widgets](structure-widgets.md), o cualquier
+otro lugar llamando a los métodos de renderización de vistas. Estos métodos comparten una firma similar, como se muestra a continuación:
+
+```
+/**
+ * @param string $view nombre de la vista o ruta al archivo, dependiendo del método de renderización utilizado
+ * @param array $params los datos pasados a la vista
+ * @return string el resultado de la renderización
+ */
+methodName($view, $params = [])
+```
+
+
+### Renderizando en Controladores
+
+Dentro de los [controladores](structure-controllers.md), puedes llamar al siguiente método del controlador para renderizar una vista:
+
+* [[yii\base\Controller::render()|render()]]: renderiza la [vista nombrada](#named-views) y aplica un [layout](#layouts)
+ al resultado de la renderización.
+* [[yii\base\Controller::renderPartial()|renderPartial()]]: renderiza la [vista nombrada](#named-views) sin ningún layout aplicado.
+* [[yii\web\Controller::renderAjax()|renderAjax()]]: renderiza la [vista nombrada](#named-views) sin layout,
+ e inyecta todos los scripts y archivos JS/CSS registrados. Esto sucede usualmente en respuestas a llamadas a AJAX `requests`.
+* [[yii\base\Controller::renderFile()|renderFile()]]: renderiza la vista especificada en términos de la ruta al archivo o
+ [alias](concept-aliases.md).
+
+Por ejemplo:
+
+```php
+namespace app\controllers;
+
+use Yii;
+use app\models\Post;
+use yii\web\Controller;
+use yii\web\NotFoundHttpException;
+
+class PostController extends Controller
+{
+ public function actionView($id)
+ {
+ $model = Post::findOne($id);
+ if ($model === null) {
+ throw new NotFoundHttpException;
+ }
+
+ // renderiza una vista llamada "view" y le aplica el layout
+ return $this->render('view', [
+ 'model' => $model,
+ ]);
+ }
+}
+```
+
+
+### Renderizando en Widgets
+
+Dentro de [widgets](structure-widgets.md), puedes llamar a cualquier de los siguientes métodos de widget para renderizar una vista.
+
+* [[yii\base\Widget::render()|render()]]: renderiza la [vista nombrada](#named-views).
+* [[yii\base\Widget::renderFile()|renderFile()]]: renderiza la vista especificada en términos de ruta al archivo o
+ [alias](concept-aliases.md).
+
+Por ejemplo:
+
+```php
+namespace app\components;
+
+use yii\base\Widget;
+use yii\helpers\Html;
+
+class ListWidget extends Widget
+{
+ public $items = [];
+
+ public function run()
+ {
+ // renderiza una vista llamada "list"
+ return $this->render('list', [
+ 'items' => $this->items,
+ ]);
+ }
+}
+```
+
+
+### Renderizando en Vistas
+
+Puedes renderizar una vista dentro de otra vista llamando a algunos de los siguientes métodos provistos por el [[yii\base\View|componente view]]:
+
+* [[yii\base\View::render()|render()]]: renderiza la [vista nombrada](#named-views).
+* [[yii\web\View::renderAjax()|renderAjax()]]: renderiza la [vista nombrada](#named-views) e inyecta todos los
+ archivos y scripts JS/CSS. Esto sucede usualmente en respuestas a llamadas a AJAX `requests`.
+* [[yii\base\View::renderFile()|renderFile()]]: renderiza la vista especificada en términos de ruta al archivo o
+ [alias](concept-aliases.md).
+
+Por ejemplo, el siguiente código en una vista renderiza el template `_overview.php` encontrado en el mismo directorio
+de la vista renderizada actualmente. Recuerda que la variable `$this` en una vista se refiere al componente [[yii\base\View|view]]:
+
+```php
+render('_overview') ?>
+```
+
+
+### Renderizando en Otros Lugares
+
+En cualquier lugar, puedes tener acceso al componente [[yii\base\View|view]] utilizando la expresión
+`Yii::$app->view` y entonces llamar a los métodos previamente mencionados para renderizar una vista. Por ejemplo:
+
+```php
+// muestra el template "@app/views/site/license.php"
+echo \Yii::$app->view->renderFile('@app/views/site/license.php');
+```
+
+
+### Vistas Nombradas
+
+Cuando renderizas una vista, puedes especificar el template utilizando tanto el nombre de la vista o la ruta/alias al archivo. En la mayoría de los casos,
+utilizarías la primera porque es más concisa y flexible. *Vistas nombradas* son vistas especificadas mediante un nombre en vez de una ruta al archivo o alias.
+
+Un nombre de vista es resuelto a su correspondiente ruta de archivo siguiendo las siguientes reglas:
+
+* Un nombre de vista puede omitir la extensión del archivo. En estos casos se utilizará `.php` como extensión del archivo. Por ejemplo,
+ el nombre de vista `about` corresponde al archivo `about.php`.
+* Si el nombre de la vista comienza con doble barra (`//`), la ruta al archivo correspondiente será `@app/views/ViewName`.
+ Esto quiere decir que la vista es buscada bajo el [[yii\base\Application::viewPath|view path de la aplicación]].
+ Por ejemplo, `//site/about` será resuelto como `@app/views/site/about.php`.
+* Si el nombre de la vista comienza con una barra simple `/`, la ruta al archivo de la vista utilizará como prefijo el nombre de la vista
+ con el [[yii\base\Module::viewPath|view path]] del [módulo](structure-modules.md) utilizado actualmente.
+ Si no hubiera módulo activo se utilizará `@app/views/ViewName`. Por ejemplo, `/user/create` será resuelto a
+ `@app/modules/user/views/user/create.php` si el módulo activo es `user`. Si no hubiera módulo activo,
+ la ruta al archivo será `@app/views/user/create.php`.
+* Si la vista es renderizada con un [[yii\base\View::context|context]] y dicho contexto implementa [[yii\base\ViewContextInterface]],
+ la ruta al archivo se forma utilizando como prefijo el [[yii\base\ViewContextInterface::getViewPath()|view path]]
+ del contexto de la vista. Esto principalmente aplica a vistas renderizadas en controladores y widgets. Por ejemplo,
+ `site/about` será resuelto a `@app/views/site/about.php` si el contexto es el controlador `SiteController`.
+* Si la vista es renderizada dentro de otra vista, el directorio que contiene la otra vista será prefijado
+ al nuevo nombre de la vista para formar la ruta a la vista. Por ejemplo, `item` sera resuelto a `@app/views/post/item`
+ si está siendo renderizado desde la vista `@app/views/post/index.php`.
+
+De acuerdo a las reglas mencionadas, al llamar a `$this->render('view')` en el controlador `app\controllers\PostController`
+se renderizará el template `@app/views/post/view.php`, mientras que llamando a `$this->render('_overview')` en la vista
+renderizará el template `@app/views/post/_overview.php`.
+
+
+### Accediendo a Datos en la Vista
+
+Hay dos modos posibles de acceder a los datos en la vista: push (inyectar) y pull (traer).
+
+Al pasar los datos como segundo parámetro en algún método de renderización, estás utilizando el modo push.
+Los datos deberían ser representados como un array de pares clave-valor. Cuando la vista está siendo renderizada, la función PHP
+`extract()` será llamada sobre este array así se extraen las variables que contiene a la vista actual .
+Por ejemplo, el siguiente código de renderización en un controlador inyectará dos variables a la vista `report`:
+`$foo = 1` and `$bar = 2`.
+
+```php
+echo $this->render('report', [
+ 'foo' => 1,
+ 'bar' => 2,
+]);
+```
+
+El modo pull obtiene los datos del [[yii\base\View|componente view]] u otros objetos accesibles
+en las vistas (ej. `Yii::$app`). Utilizando el código anterior como ejemplo, dentro de una vista puedes acceder al objeto del controlador
+a través de la expresión `$this->context`. Como resultado, te es posible acceder a cualquier propiedad o método
+del controlador en la vista `report`, tal como el ID del controlador como se muestra a continuación:
+
+```php
+El ID del controlador es: context->id ?>
+?>
+```
+
+Para acceder a datos en la vista, normalmente se prefiere el modo push, ya que hace a la vista menos dependiente
+de los objetos del contexto. La contra es que tienes que construir el array manualmente cada vez, lo que podría
+volverse tedioso y propenso al error si la misma vista es compartida y renderizada desde diferentes lugares.
+
+
+### Compartiendo Datos Entre las Vistas
+
+El [[yii\base\View|componente view]] provee la propiedad [[yii\base\View::params|params]] para que puedas compartir
+datos entre diferentes vistas.
+
+Por ejemplo, en una vista `about`, podrías tener el siguiente código que especifica el segmento actual
+del breadcrumbs (migas de pan).
+
+```php
+$this->params['breadcrumbs'][] = 'Acerca de Nosotros';
+```
+
+Entonces, en el archivo del [layout](#layouts), que es también una vista, puedes mostrar el breadcrumbs utilizando los datos
+pasados a través de [[yii\base\View::params|params]]:
+
+```php
+ isset($this->params['breadcrumbs']) ? $this->params['breadcrumbs'] : [],
+]) ?>
+```
+
+
+## Layouts
+
+Los layouts son un tipo especial de vista que representan partes comunes de otras múltiples vistas. Por ejemplo, las páginas
+de la mayoría de las aplicaciones Web comparten el mismo encabezado y pie de página. Aunque puedes repetirlos en todas y cada una
+de las vistas, una mejor forma es hacerlo sólo en el layout e incrustar el resultado de la renderización de la vista en
+un lugar apropiado del mismo.
+
+
+### Creando Layouts
+
+Dado que los layouts son también vistas, pueden ser creados de manera similar a las vistas comunes. Por defecto, los layouts
+son guardados en el directorio `@app/views/layouts`. Para layouts utilizados dentro de un [módulo](structure-modules.md),
+deberían ser guardados en el directorio `views/layouts` bajo el [[yii\base\Module::basePath|directorio del módulo]].
+Puedes personalizar el directorio de layouts por defecto configurando la propiedad [[yii\base\Module::layoutPath]] de
+la aplicación o módulos.
+
+El siguiente ejemplo muestra cómo debe verse un layout. Ten en cuenta que por motivos ilustrativos, hemos simplificado bastante
+el código del layout. En la práctica, probablemente le agregues más contenido, como tags en el `head`, un menú principal, etc.
+
+```php
+
+beginPage() ?>
+
+
+
+
+
+ <?= Html::encode($this->title) ?>
+ head() ?>
+
+
+beginBody() ?>
+ Mi Compañía
+
+
+endBody() ?>
+
+
+endPage() ?>
+```
+
+Como puedes ver, el layout genera los tags HTML comunes a todas las páginas. Dentro de la sección ``,
+el layout imprime la variable `$content`, que representa el resultado de la renderización del contenido de cada vista y es incrustado
+dentro del layout cuando se llama al método [[yii\base\Controller::render()]].
+
+La mayoría de layouts deberían llamar a los siguientes métodos (como fue mostrado recién). Estos métodos principalmente disparan eventos
+acerca del proceso de renderizado así los scripts y tags registrados en otros lugares pueden ser propiamente inyectados en
+los lugares donde los métodos son llamados.
+
+- [[yii\base\View::beginPage()|beginPage()]]: Este método debería ser llamado bien al principio del layout.
+ Esto dispara el evento [[yii\base\View::EVENT_BEGIN_PAGE|EVENT_BEGIN_PAGE]], el cual indica el comienzo de la página.
+- [[yii\base\View::endPage()|endPage()]]: Este método debería ser llamado al final del layout.
+ Esto dispara el evento [[yii\base\View::EVENT_END_PAGE|EVENT_END_PAGE]], indicando el final de la página.
+- [[yii\web\View::head()|head()]]: Este método debería llamarse dentro de la sección `` de una página HTML.
+ Esto genera un espacio vacío que será reemplazado con el código del head HTML registrado (ej. link tags, meta tags)
+ cuando una página finaliza el renderizado.
+- [[yii\base\View::beginBody()|beginBody()]]: Este método debería llamarse al principio de la sección ``.
+ Esto dispara el evento [[yii\web\View::EVENT_BEGIN_BODY|EVENT_BEGIN_BODY]] y genera un espacio vacío que será
+ reemplazado con el código HTML registrado (ej. JavaScript) que apunta al principio del body.
+- [[yii\base\View::endBody()|endBody()]]: Este método debería llamarse al final de la sección ``.
+ Esto dispara el evento [[yii\web\View::EVENT_END_BODY|EVENT_END_BODY]], que genera un espacio vacío a ser reemplazado
+ por el código HTML registrado (ej. JavaScript) que apunta al final del body.
+
+
+### Accediendo a Datos en Layouts
+
+Dentro de un layout, tienes acceso a dos variables predefinidas: `$this` y `$content`. La primera se refiere
+al componente [[yii\base\View|view]], como en cualquier vista, mientras que la última contiene el resultado de la renderización del contenido
+de la vista que está siendo renderizada all llamar al método [[yii\base\Controller::render()|render()]] en los controladores.
+
+Si quieres acceder a otros datos en los layouts, debes utilizar el modo pull que fue descrito en la sub-sección
+[Accediendo a Datos en la Vista](#accessing-data-in-views). Si quieres pasar datos desde al contenido de la vista
+a un layout, puedes utilizar el método descrito en la sub-sección [Compartiendo Datos Entre las Vistas](#sharing-data-among-views).
+
+
+### Utilizando Layouts
+
+Como se describe en la sub-sección [Renderizando en Controllers](#rendering-in-controllers), cuando renderizas una vista
+llamando al método [[yii\base\Controller::render()|render()]] en un controlador, al resultado de dicha renderización
+le será aplicado un layout. Por defecto, el layout `@app/views/layouts/main.php` será el utilizado.
+
+Puedes utilizar un layout diferente configurando la propiedad [[yii\base\Application::layout]] o [[yii\base\Controller::layout]].
+El primero se refiere al layout utilizado por todos los controladores, mientras que el último sobrescribe el layout en controladores individuales.
+Por ejemplo, el siguiente código hace que el controlador `post` utilice `@app/views/layouts/post.php` como layout
+al renderizar sus vistas. Otros controladores, asumiendo que su propiedad `layout` no fue modificada, utilizarán
+`@app/views/layouts/main.php` como layout.
+
+```php
+namespace app\controllers;
+
+use yii\web\Controller;
+
+class PostController extends Controller
+{
+ public $layout = 'post';
+
+ // ...
+}
+```
+
+Para controladores que pertencen a un módulo, puedes también configurar la propiedad [[yii\base\Module::layout|layout]] y así
+utilizar un layout en particular para esos controladores.
+
+Dado que la propiedad `layout` puede ser configurada en diferentes niveles (controladores, módulos, aplicación),
+detrás de escena Yii realiza dos pasos para determinar cuál es el archivo de layout siendo utilizado para un controlador en particular.
+
+En el primer paso, determina el valor del layout y el módulo de contexto:
+
+- Si la propiedad [[yii\base\Controller::layout]] no es `null`, la utiliza como valor del layout y
+ el [[yii\base\Controller::module|módulo]] del controlador como el módulo de contexto.
+- Si [[yii\base\Controller::layout|layout]] es `null`, busca a través de todos los módulos ancestros del controlador y
+ encuentra el primer módulo cuya propiedad [[yii\base\Module::layout|layout]] no es `null`. Utiliza ese módulo y
+ su valor de [[yii\base\Module::layout|layout]] como módulo de contexto y como layout seleccionado.
+ Si tal módulo no puede ser encontrado, significa que no se aplicará ningún layout.
+
+En el segundo paso, se determina el archivo de layout actual de acuerdo al valor de layout y el módulo de contexto
+determinado en el primer paso. El valor de layout puede ser:
+
+- un alias de ruta (ej. `@app/views/layouts/main`).
+- una ruta absoluta (ej. `/main`): el valor del layout comienza con una barra. El archivo de layout actual será
+ buscado bajo el [[yii\base\Application::layoutPath|layout path]] de la aplicación, que es por defecto
+ `@app/views/layouts`.
+- una ruta relativa (ej. `main`): El archivo de layout actual será buscado bajo el
+ [[yii\base\Module::layoutPath|layout path]] del módulo de contexto, que es por defecto el directorio `views/layouts`
+ bajo el [[yii\base\Module::basePath|directorio del módulo]].
+- el valor booleano `false`: no se aplicará ningún layout.
+
+Si el valor de layout no contiene una extensión de tipo de archivo, utilizará por defecto `.php`.
+
+
+### Layouts Anidados
+
+A veces podrías querer anidar un layout dentro de otro. Por ejemplo, en diferentes secciones de un sitio Web, podrías
+querer utilizar layouts diferentes, mientras que todos esos layouts comparten el mismo layout básico que genera la
+estructura general de la página en HTML5. Esto es posible llamando a los métodos [[yii\base\View::beginContent()|beginContent()]] y
+[[yii\base\View::endContent()|endContent()]] en los layouts hijos como se muestra a continuación:
+
+```php
+beginContent('@app/views/layouts/base.php'); ?>
+
+...contenido del layout hijo aquí...
+
+endContent(); ?>
+```
+
+Como se acaba de mostrar, el contenido del layout hijo debe ser encerrado dentro de [[yii\base\View::beginContent()|beginContent()]] y
+[[yii\base\View::endContent()|endContent()]]. El parámetro pasado a [[yii\base\View::beginContent()|beginContent()]]
+especifica cuál es el módulo padre. Este puede ser tanto un archivo layout como un alias.
+
+Utilizando la forma recién mencionada, puedes anidar layouts en más de un nivel.
+
+
+## Utilizando Componentes de Vista
+
+Los [[yii\base\View|componentes de vista]] proveen características relacionadas a las vistas. Aunque puedes obtener componentes de vista
+creando instancias individuales de [[yii\base\View]] o sus clases hijas, en la mayoría de los casos utilizarías el
+componente `view` del a aplicación. Puedes configurar este componente en la [configuración de la aplicación](structure-applications.md#application-configurations)
+como a continuación:
+
+```php
+[
+ // ...
+ 'components' => [
+ 'view' => [
+ 'class' => 'app\components\View',
+ ],
+ // ...
+ ],
+]
+```
+
+Los componentes de vista proveen las siguientes características útiles, cada una descrita en mayor detalle en su propia sección:
+
+* [temas](output-theming.md): te permite desarrollar y cambiar el tema (theme) de tu sitio Web.
+* [caché de fragmentos](caching-fragment.md): te permite guardar en cache un fragmento de una página Web.
+* [manejo de scripts del cliente](output-client-scripts.md): soporte para registro y renderización de CSS y JavaScript.
+* [manejo de asset bundle](structure-assets.md): soporte de registro y renderización de [asset bundles](structure-assets.md).
+* [motores de template alternativos](tutorial-template-engines.md): te permite utilizar otros motores de templates, como
+ [Twig](http://twig.sensiolabs.org/) o [Smarty](http://www.smarty.net/).
+
+Puedes también utilizar frecuentemente el siguiente menor pero útil grupo de características al desarrollar páginas Web.
+
+
+### Definiendo Títulos de Página
+
+Toda página Web debería tener un título. Normalmente el tag de título es generado en [layout](#layouts). De todos modos, en la práctica
+el título es determinado en el contenido de las vistas más que en layouts. Para resolver este problema, [[yii\web\View]] provee
+la propiedad [[yii\web\View::title|title]] para que puedas pasar información del título desde el contenido de la vista a los layouts.
+
+Para utilizar esta característica, en cada contenido de la vista, puedes definir el título de la siguiente manera:
+
+```php
+title = 'Mi título de página';
+?>
+```
+
+Entonces en el layout, asegúrate de tener el siguiente código en la sección `` de la página:
+
+```php
+<?= Html::encode($this->title) ?>
+```
+
+
+### Registrando Meta Tags
+
+Las páginas Web usualmente necesitan generar varios meta tags necesarios por diferentes grupos (ej. Facebook, motores de búsqueda, etc).
+Cómo los títulos de página, los meta tags aparecen en la sección `` y son usualmente generado en los layouts.
+
+Si quieres especificar cuáles meta tags generar en las vistas, puedes llamar a [[yii\web\View::registerMetaTag()]]
+dentro de una de ellas, como se muestra a continuación:
+
+```php
+registerMetaTag(['name' => 'keywords', 'content' => 'yii, framework, php']);
+?>
+```
+
+El código anterior registrará el meta tag "keywords" a través del componente view. El meta tag registrado no
+se renderiza hasta que finaliza el renderizado del layout. Para entonces, el siguiente código HTML será insertado
+en el lugar donde llamas a [[yii\web\View::head()]] en el layout, generando el siguiente HTML:
+
+```php
+
+```
+
+Ten en cuenta que si llamas a [[yii\web\View::registerMetaTag()]] varias veces, esto registrará varios meta tags,
+sin tener en cuenta si los meta tags son los mismo o no.
+
+Para asegurarte de que sólo haya una instancia de cierto tipo de meta tag, puedes especificar una clave al llamar al método.
+Por ejemplo, el siguiente código registra dos meta tags "description", aunque sólo el segundo será renderizado.
+
+```html
+$this->registerMetaTag(['name' => 'description', 'content' => 'Este es mi sitio Web cool hecho con Yii!'], 'description');
+$this->registerMetaTag(['name' => 'description', 'content' => 'Este sitio Web es sobre mapaches graciosos.'], 'description');
+```
+
+
+### Registrando Link Tags
+
+Tal como los [meta tags](#adding-meta-tags), los link tags son útiles en muchos casos, como personalizar el ícono (favicon) del sitio, apuntar a
+una fuente de RSS o delegar OpenID a otro servidor. Puedes trabajar con link tags, al igual que con meta tags,
+utilizando [[yii\web\View::registerLinkTag()]]. Por ejemplo, en el contenido de una vista, puedes registrar un link tag como se muestra a continuación:
+
+```php
+$this->registerLinkTag([
+ 'title' => 'Noticias en Vivo de Yii',
+ 'rel' => 'alternate',
+ 'type' => 'application/rss+xml',
+ 'href' => 'http://www.yiiframework.com/rss.xml/',
+]);
+```
+
+El resultado del código es el siguiente:
+
+```html
+
+```
+
+Al igual que con [[yii\web\View::registerMetaTag()|registerMetaTags()]], puedes especificar una clave al llamar a
+[[yii\web\View::registerLinkTag()|registerLinkTag()]] para evitar registrar link tags repetidos.
+
+
+## Eventos de Vistas
+
+Los [[yii\base\View|componentes de vistas]] disparan varios eventos durante el proceso de renderizado de la vista. Puedes responder
+a estos eventos para inyectar contenido a la vista o procesar el resultado de la renderización antes de que sea enviada al usuario final.
+
+- [[yii\base\View::EVENT_BEFORE_RENDER|EVENT_BEFORE_RENDER]]: disparado al principio del renderizado de un archivo
+ en un controlador. Los manejadores de este evento pueden definir [[yii\base\ViewEvent::isValid]] como `false` para cancelar el proceso de renderizado.
+- [[yii\base\View::EVENT_AFTER_RENDER|EVENT_AFTER_RENDER]]: disparado por la llamada a [[yii\base\View::beginPage()]] en layouts.
+ Los manejadores de este evento pueden obtener el resultado de la renderización a través de [[yii\base\ViewEvent::output]] y entonces modificar
+ esta propiedad para así cambiar el mismo.
+- [[yii\base\View::EVENT_BEGIN_PAGE|EVENT_BEGIN_PAGE]]: disparado por la llamada a [[yii\base\View::beginPage()]] en layouts.
+- [[yii\base\View::EVENT_END_PAGE|EVENT_END_PAGE]]: disparado por la llamada a [[yii\base\View::endPage()]] en layouts.
+- [[yii\web\View::EVENT_BEGIN_BODY|EVENT_BEGIN_BODY]]: disparado por la llamada a [[yii\web\View::beginBody()]] en layouts.
+- [[yii\web\View::EVENT_END_BODY|EVENT_END_BODY]]: disparado por la llamada a [[yii\web\View::endBody()]] en layouts.
+
+Por ejemplo, el siguiente código inyecta la fecha actual al final del body de la página:
+
+```php
+\Yii::$app->view->on(View::EVENT_END_BODY, function () {
+ echo date('Y-m-d');
+});
+```
+
+
+## Renderizando Página Estáticas
+
+Con páginas estáticas nos referimos a esas páginas cuyo contenido es mayormente estático y sin necesidad de acceso
+a datos dinámicos enviados desde los controladores.
+
+Puedes generar páginas estáticas utilizando un código como el que sigue dentro de un controlador:
+
+```php
+public function actionAbout()
+{
+ return $this->render('about');
+}
+```
+
+Si un sitio Web contiene muchas páginas estáticas, resultaría tedioso repetir el mismo código en muchos lados.
+Para resolver este problema, puedes introducir una [acción independiente](structure-controllers.md#standalone-actions)
+llamada [[yii\web\ViewAction]] en el controlador. Por ejemplo,
+
+```php
+namespace app\controllers;
+
+use yii\web\Controller;
+
+class SiteController extends Controller
+{
+ public function actions()
+ {
+ return [
+ 'page' => [
+ 'class' => 'yii\web\ViewAction',
+ ],
+ ];
+ }
+}
+```
+
+Ahora, si creamos una vista llamada `about` bajo el directorio `@app/views/site/pages`, serás capáz
+de mostrarla en la siguiente URL:
+
+```
+http://localhost/index.php?r=site/page&view=about
+```
+
+El parámetro `GET` `view` le comunica a [[yii\web\ViewAction]] cuál es la vista solicitada. La acción entonces buscará
+esta vista dentro de `@app/views/site/pages`. Puedes configurar la propiedad [[yii\web\ViewAction::viewPrefix]]
+para cambiar el directorio en el que se buscarán dichas páginas.
+
+
+## Buenas Prácticas
+
+Las vistas son responsables de la presentación de modelos en el formato que el usuario final desea. En general, las vistas
+
+* deberían contener principalmente sólo código de presentación, como HTML, y PHP simple para recorrer, dar formato y renderizar datos.
+* no deberían contener código que realiza consultas a la base de datos. Ese tipo de código debe ir en los modelos.
+* deberían evitar el acceso directo a datos del `request`, como `$_GET` y/o `$_POST`. Esto es una responsabilidad de los controladores.
+ Si se necesitan datos del `request`, deben ser inyectados a la vista desde el controlador.
+* pueden leer propiedades del modelo, pero no debería modificarlas.
+
+Para hacer las vistas más manejables, evita crear vistas que son demasiado complejas o que contengan código redundante.
+Puedes utilizar estas técnicas para alcanzar dicha meta:
+
+* utiliza [layouts](#layouts) para representar secciones comunes (ej. encabezado y footer de la página).
+* divide una vista compleja en varias más simples. Las vistas pequeñas pueden ser renderizadas y unidas una mayor
+ utilizando los métodos de renderización antes descritos.
+* crea y utiliza [widgets](structure-widgets.md) como bloques de construcción de la vista.
+* crea y utilizar helpers para transformar y dar formato a los datos en la vista.
+
diff --git a/docs/guide-fr/README.md b/docs/guide-fr/README.md
index b0fa7bcebe..80eed47b36 100644
--- a/docs/guide-fr/README.md
+++ b/docs/guide-fr/README.md
@@ -24,7 +24,7 @@ Mise en Route
* [Travailler avec les formulaires](start-forms.md)
* [Travailler avec les bases de données](start-databases.md)
* [Générer du code avec Gii](start-gii.md)
-* [En savoir plus](start-looking-head.md)
+* [En savoir plus](start-looking-ahead.md)
Structure Application
diff --git a/docs/guide-pt-BR/README.md b/docs/guide-pt-BR/README.md
index 505da70b53..66e0b9b58c 100644
--- a/docs/guide-pt-BR/README.md
+++ b/docs/guide-pt-BR/README.md
@@ -24,7 +24,7 @@ Primeiros Passos
* [Trabalhando com Formulários](start-forms.md)
* [Trabalhando com Banco de Dados](start-databases.md)
* [Gerando Código com Gii](start-gii.md)
-* [Visão Geral](start-looking-head.md)
+* [Visão Geral](start-looking-ahead.md)
Estrutura de uma Aplicação
diff --git a/docs/guide-ru/README.md b/docs/guide-ru/README.md
index 86b3892312..c08eea48f8 100644
--- a/docs/guide-ru/README.md
+++ b/docs/guide-ru/README.md
@@ -24,7 +24,7 @@ All Rights Reserved.
* [Работа с формами](start-forms.md)
* [Работа с базами данных](start-databases.md)
* [Генерация кода при помощи Gii](start-gii.md)
-* [Что дальше?](start-looking-head.md)
+* [Что дальше?](start-looking-ahead.md)
Структура приложения
diff --git a/docs/guide-ru/start-looking-head.md b/docs/guide-ru/start-looking-ahead.md
similarity index 100%
rename from docs/guide-ru/start-looking-head.md
rename to docs/guide-ru/start-looking-ahead.md
diff --git a/docs/guide-uk/README.md b/docs/guide-uk/README.md
index eddff91282..e397b2724b 100644
--- a/docs/guide-uk/README.md
+++ b/docs/guide-uk/README.md
@@ -24,7 +24,7 @@ All Rights Reserved.
* [Робота з формами](start-forms.md)
* [Робота з базами даних](start-databases.md)
* [Генерація коду за допомогою Gii](start-gii.md)
-* [Що далі?](start-looking-head.md)
+* [Що далі?](start-looking-ahead.md)
Структура додатка
diff --git a/docs/guide-zh-CN/README.md b/docs/guide-zh-CN/README.md
index 23ed6abb7d..8618e66340 100644
--- a/docs/guide-zh-CN/README.md
+++ b/docs/guide-zh-CN/README.md
@@ -23,7 +23,7 @@ Yii 2.0 权威指南
* **已定稿** [使用 Forms](start-forms.md)
* **已定稿** [玩转 Databases](start-databases.md)
* **已定稿** [用 Gii 生成代码](start-gii.md)
-* **已定稿** [更上一层楼](start-looking-head.md)
+* **已定稿** [更上一层楼](start-looking-ahead.md)
应用结构
--------
diff --git a/docs/guide/README.md b/docs/guide/README.md
index d25be5a4cc..37caef150e 100644
--- a/docs/guide/README.md
+++ b/docs/guide/README.md
@@ -24,7 +24,7 @@ Getting Started
* [Working with Forms](start-forms.md)
* [Working with Databases](start-databases.md)
* [Generating Code with Gii](start-gii.md)
-* [Looking Ahead](start-looking-head.md)
+* [Looking Ahead](start-looking-ahead.md)
Application Structure
diff --git a/docs/guide/start-looking-head.md b/docs/guide/start-looking-ahead.md
similarity index 100%
rename from docs/guide/start-looking-head.md
rename to docs/guide/start-looking-ahead.md
diff --git a/docs/internals/translation-status.md b/docs/internals/translation-status.md
index d93a9ae981..e3d87fab0c 100644
--- a/docs/internals/translation-status.md
+++ b/docs/internals/translation-status.md
@@ -12,7 +12,7 @@ start-hello.md | Yes
start-forms.md | Yes
start-databases.md | Yes
start-gii.md | Yes
-start-looking-head.md | Yes
+start-looking-ahead.md | Yes
structure-overview.md | Yes
structure-entry-scripts.md | Yes
structure-applications.md | Yes
@@ -102,8 +102,8 @@ tutorial-performance-tuning.md |
tutorial-shared-hosting.md |
tutorial-template-engines.md |
tutorial-core-validators.md | Yes
-bootstrap-widgets.md |
-jui-widgets.md |
+widget-bootstrap.md |
+widget-jui.md |
helper-overview.md |
helper-array.md |
helper-html.md |
diff --git a/extensions/elasticsearch/CHANGELOG.md b/extensions/elasticsearch/CHANGELOG.md
index 60ab3fe785..e4d54a01a1 100644
--- a/extensions/elasticsearch/CHANGELOG.md
+++ b/extensions/elasticsearch/CHANGELOG.md
@@ -7,6 +7,7 @@ Yii Framework 2 elasticsearch extension Change Log
- Bug #3587: Fixed an issue with storing empty records (cebe)
- Enh #3520: Added `unlinkAll()`-method to active record to remove all records of a model relation (NmDimas, samdark, cebe)
- Enh #3527: Added `highlight` property to Query and ActiveRecord. (Borales)
+- Enh: Make error messages more readable in HTML output (cebe)
- Chg: asArray in ActiveQuery is now equal to using the normal Query. This means, that the output structure has changed and `with` is supported anymore. (cebe)
- Chg: Deletion of a record is now also considered successful if the record did not exist. (cebe)
- Chg: Requirement changes: Yii now requires elasticsearch version 1.0 or higher (cebe)
diff --git a/extensions/elasticsearch/Connection.php b/extensions/elasticsearch/Connection.php
index 8a8124dbad..594f5033c2 100644
--- a/extensions/elasticsearch/Connection.php
+++ b/extensions/elasticsearch/Connection.php
@@ -10,6 +10,7 @@ namespace yii\elasticsearch;
use Yii;
use yii\base\Component;
use yii\base\InvalidConfigException;
+use yii\base\InvalidParamException;
use yii\helpers\Json;
/**
@@ -381,7 +382,7 @@ class Connection extends Component
'requestUrl' => $url,
'requestBody' => $requestBody,
'responseHeaders' => $headers,
- 'responseBody' => $body,
+ 'responseBody' => $this->decodeErrorBody($body),
]);
}
@@ -403,7 +404,7 @@ class Connection extends Component
'requestBody' => $requestBody,
'responseCode' => $responseCode,
'responseHeaders' => $headers,
- 'responseBody' => $body,
+ 'responseBody' => $this->decodeErrorBody($body),
]);
}
if (isset($headers['content-type']) && !strncmp($headers['content-type'], 'application/json', 16)) {
@@ -415,7 +416,7 @@ class Connection extends Component
'requestBody' => $requestBody,
'responseCode' => $responseCode,
'responseHeaders' => $headers,
- 'responseBody' => $body,
+ 'responseBody' => $this->decodeErrorBody($body),
]);
}
} elseif ($responseCode == 404) {
@@ -427,11 +428,29 @@ class Connection extends Component
'requestBody' => $requestBody,
'responseCode' => $responseCode,
'responseHeaders' => $headers,
- 'responseBody' => $body,
+ 'responseBody' => $this->decodeErrorBody($body),
]);
}
}
+ /**
+ * Try to decode error information if it is valid json, return it if not.
+ * @param $body
+ * @return mixed
+ */
+ protected function decodeErrorBody($body)
+ {
+ try {
+ $decoded = Json::decode($body);
+ if (isset($decoded['error'])) {
+ $decoded['error'] = preg_replace('/\b\w+?Exception\[/', "\\0\n ", $decoded['error']);
+ }
+ return $decoded;
+ } catch(InvalidParamException $e) {
+ return $body;
+ }
+ }
+
public function getNodeInfo()
{
return $this->get([]);
diff --git a/framework/CHANGELOG.md b/framework/CHANGELOG.md
index 4db487722f..cb3db25b6a 100644
--- a/framework/CHANGELOG.md
+++ b/framework/CHANGELOG.md
@@ -134,6 +134,7 @@ Yii Framework 2 Change Log
- Enh: Added param `hideOnSinglePage` to `yii\widgets\LinkPager` (arturf)
- Enh: Added support for array attributes in `in` validator (creocoder)
- Enh: Improved `yii\helpers\Inflector::slug` to support more cases for Russian, Hebrew and special characters (samdark)
+- Enh: ListView now uses the widget ID in the base tag, consistent to gridview (cebe)
- Chg #2287: Split `yii\db\ColumnSchema::typecast()` into two methods `phpTypecast()` and `dbTypecast()` to allow specifying PDO type explicitly (cebe)
- Chg #2898: `yii\console\controllers\AssetController` is now using hashes instead of timestamps (samdark)
- Chg #2913: RBAC `DbManager` is now initialized via migration (samdark)
@@ -150,6 +151,7 @@ Yii Framework 2 Change Log
- Chg #3897: Raised visibility of `yii\web\View::registerAssetFiles()` to protected (samdark)
- Chg #3899: Moved `MailEvent` class to `yii\mail` namespace (cebe)
- Chg #3956: Flash messages set via `Yii::$app->session->setFlash()` will be removed only if they are accessed (qiangxue)
+- Chg #3989: The default value for `yii\log\FileTarget::$rotateByCopy` now defaults to true to work on windows by default (cebe)
- Chg #4071: `mail` component renamed to `mailer`, `yii\log\EmailTarget::$mail` renamed to `yii\log\EmailTarget::$mailer` (samdark)
- Chg: Replaced `clearAll()` and `clearAllAssignments()` in `yii\rbac\ManagerInterface` with `removeAll()`, `removeAllRoles()`, `removeAllPermissions()`, `removeAllRules()` and `removeAllAssignments()` (qiangxue)
- Chg: Added `$user` as the first parameter of `yii\rbac\Rule::execute()` (qiangxue)
diff --git a/framework/base/Module.php b/framework/base/Module.php
index 9e8947b576..53348d5d9c 100644
--- a/framework/base/Module.php
+++ b/framework/base/Module.php
@@ -160,7 +160,7 @@ class Module extends ServiceLocator
public static function setInstance($instance)
{
if ($instance === null) {
- unset(self::$_instances[get_class()]);
+ unset(self::$_instances[get_called_class()]);
} else {
self::$_instances[get_class($instance)] = $instance;
}
diff --git a/framework/grid/GridView.php b/framework/grid/GridView.php
index be34140965..79d426f663 100644
--- a/framework/grid/GridView.php
+++ b/framework/grid/GridView.php
@@ -219,9 +219,6 @@ class GridView extends BaseListView
if (!$this->formatter instanceof Formatter) {
throw new InvalidConfigException('The "formatter" property must be either a Format object or a configuration array.');
}
- if (!isset($this->options['id'])) {
- $this->options['id'] = $this->getId();
- }
if (!isset($this->filterRowOptions['id'])) {
$this->filterRowOptions['id'] = $this->options['id'] . '-filters';
}
diff --git a/framework/helpers/BaseFileHelper.php b/framework/helpers/BaseFileHelper.php
index 2d2cfdcaa2..4ef019c3a4 100644
--- a/framework/helpers/BaseFileHelper.php
+++ b/framework/helpers/BaseFileHelper.php
@@ -277,32 +277,29 @@ class BaseFileHelper
*/
public static function removeDirectory($dir, $options = [])
{
- if (!isset($options['traverseSymlinks'])) {
- $options['traverseSymlinks'] = false;
- }
- if (!is_dir($dir) || !($handle = opendir($dir))) {
+ if (!is_dir($dir)) {
return;
}
- while (($file = readdir($handle)) !== false) {
- if ($file === '.' || $file === '..') {
- continue;
+ if (!is_link($dir) || isset($options['traverseSymlinks']) && $options['traverseSymlinks']) {
+ if (!($handle = opendir($dir))) {
+ return;
}
- $path = $dir . DIRECTORY_SEPARATOR . $file;
- if (is_link($path)) {
- if ($options['traverseSymlinks'] && is_dir($path)) {
- static::removeDirectory($path, $options);
+ while (($file = readdir($handle)) !== false) {
+ if ($file === '.' || $file === '..') {
+ continue;
}
- unlink($path);
- } else {
- if (is_file($path)) {
- unlink($path);
+ $path = $dir . DIRECTORY_SEPARATOR . $file;
+ if (is_dir($path)) {
+ static::removeDirectory($path, $options);
} else {
- static::removeDirectory($path, $options);
+ unlink($path);
}
}
+ closedir($handle);
}
- closedir($handle);
- if (!is_link($dir)) {
+ if (is_link($dir)) {
+ unlink($dir);
+ } else {
rmdir($dir);
}
}
diff --git a/framework/log/FileTarget.php b/framework/log/FileTarget.php
index efc3139bd8..a9ab02d2b1 100644
--- a/framework/log/FileTarget.php
+++ b/framework/log/FileTarget.php
@@ -52,16 +52,18 @@ class FileTarget extends Target
*/
public $dirMode = 0775;
/**
- * @var boolean Whether to rotate primary log by copy and truncate
- * which is more compatible with log tailers. Defaults to `false`.
+ * @var boolean Whether to rotate log files by copy and truncate in contrast to rotation by
+ * renaming files. Defaults to `true` to be more compatible with log tailers and is windows
+ * systems which do not play well with rename on open files. Rotation by renaming however is
+ * a bit faster.
*
- * This property can also be useful on windows systems where the
- * [rename()](http://www.php.net/manual/en/function.rename.php) function has some problems.
- * See the [comment by Martin Pelletier](http://www.php.net/manual/en/function.rename.php#102274) in
- * the PHP documentation for details. By setting rotateByCopy to `true` you can work
+ * The problem with windows systems where the [rename()](http://www.php.net/manual/en/function.rename.php)
+ * function does not work with files that are opened by some process is described in a
+ * [comment by Martin Pelletier](http://www.php.net/manual/en/function.rename.php#102274) in
+ * the PHP documentation. By setting rotateByCopy to `true` you can work
* around this problem.
*/
- public $rotateByCopy = false;
+ public $rotateByCopy = true;
/**
diff --git a/framework/widgets/BaseListView.php b/framework/widgets/BaseListView.php
index 90a43c724b..213f20b13b 100644
--- a/framework/widgets/BaseListView.php
+++ b/framework/widgets/BaseListView.php
@@ -101,6 +101,9 @@ abstract class BaseListView extends Widget
if ($this->emptyText === null) {
$this->emptyText = Yii::t('yii', 'No results found.');
}
+ if (!isset($this->options['id'])) {
+ $this->options['id'] = $this->getId();
+ }
}
/**