Explained the difference between Mvc\\View and Mvc\\View\\Simple's re…

…nder() method (#329, #405)

en/reference/micro.rst

@@ -639,6 +639,32 @@ Rendering Views
 
     });
 
+Please note that this code block uses :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` which uses relative paths instead of controllers and actions.
+If you would like to use :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` instead, you will need to change the parameters of the :code:`render()` method:
+
+.. code-block:: php
+
+    <?php
+
+    $app = new Phalcon\Mvc\Micro();
+
+    $app['view'] = function () {
+        $view = new \Phalcon\Mvc\View();
+        $view->setViewsDir('app/views/');
+        return $view;
+    };
+
+    // Return a rendered view
+    $app->get('/products/show', function () use ($app) {
+
+        // Render app/views/products/show.phtml passing some variables
+        echo $app['view']->render('products', 'show', array(
+            'id'   => 100,
+            'name' => 'Artichoke'
+        ));
+
+    });
+
 Error Handling
 --------------
 A proper response can be generated if an exception is raised in a micro handler:

en/reference/views.rst

@@ -539,6 +539,22 @@ To render a view it's necessary to call the render method explicitly indicating
         }
     }
 
+This is different to :doc:`Phalcon\\Mvc\\View <../api/Phalcon_Mvc_View>` who's :code:`render()` method uses controllers and actions as parameters:
+
+.. code-block:: php
+
+    <?php
+
+    $params = array('posts' => Posts::find());
+
+    // Phalcon\Mvc\View
+    $view = new \Phalcon\Mvc\View();
+    echo $view->render('posts', 'show', $params);
+
+    // Phalcon\Mvc\View\Simple
+    $simpleView = new \Phalcon\Mvc\View\Simple();
+    echo $simpleView->render('posts/show', $params);
+
 Using Partials
 --------------
 Partial templates are another way of breaking the rendering process into simpler more manageable chunks that can be reused by different

es/reference/micro.rst

@@ -639,6 +639,32 @@ Rendering Views
 
     });
 
+Please note that this code block uses :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` which uses relative paths instead of controllers and actions.
+If you would like to use :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` instead, you will need to change the parameters of the :code:`render()` method:
+
+.. code-block:: php
+
+    <?php
+
+    $app = new Phalcon\Mvc\Micro();
+
+    $app['view'] = function () {
+        $view = new \Phalcon\Mvc\View();
+        $view->setViewsDir('app/views/');
+        return $view;
+    };
+
+    // Return a rendered view
+    $app->get('/products/show', function () use ($app) {
+
+        // Render app/views/products/show.phtml passing some variables
+        echo $app['view']->render('products', 'show', array(
+            'id'   => 100,
+            'name' => 'Artichoke'
+        ));
+
+    });
+
 Error Handling
 --------------
 A proper response can be generated if an exception is raised in a micro handler:

es/reference/views.rst

@@ -539,6 +539,22 @@ To render a view it's necessary to call the render method explicitly indicating
         }
     }
 
+This is different to :doc:`Phalcon\\Mvc\\View <../api/Phalcon_Mvc_View>` who's :code:`render()` method uses controllers and actions as parameters:
+
+.. code-block:: php
+
+    <?php
+
+    $params = array('posts' => Posts::find());
+
+    // Phalcon\Mvc\View
+    $view = new \Phalcon\Mvc\View();
+    echo $view->render('posts', 'show', $params);
+
+    // Phalcon\Mvc\View\Simple
+    $simpleView = new \Phalcon\Mvc\View\Simple();
+    echo $simpleView->render('posts/show', $params);
+
 Using Partials
 --------------
 Partial templates are another way of breaking the rendering process into simpler more manageable chunks that can be reused by different

fr/reference/micro.rst

@@ -639,6 +639,32 @@ Rendering Views
 
     });
 
+Please note that this code block uses :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` which uses relative paths instead of controllers and actions.
+If you would like to use :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` instead, you will need to change the parameters of the :code:`render()` method:
+
+.. code-block:: php
+
+    <?php
+
+    $app = new Phalcon\Mvc\Micro();
+
+    $app['view'] = function () {
+        $view = new \Phalcon\Mvc\View();
+        $view->setViewsDir('app/views/');
+        return $view;
+    };
+
+    // Return a rendered view
+    $app->get('/products/show', function () use ($app) {
+
+        // Render app/views/products/show.phtml passing some variables
+        echo $app['view']->render('products', 'show', array(
+            'id'   => 100,
+            'name' => 'Artichoke'
+        ));
+
+    });
+
 Error Handling
 --------------
 A proper response can be generated if an exception is raised in a micro handler:

fr/reference/views.rst

@@ -539,6 +539,22 @@ To render a view it's necessary to call the render method explicitly indicating
         }
     }
 
+This is different to :doc:`Phalcon\\Mvc\\View <../api/Phalcon_Mvc_View>` who's :code:`render()` method uses controllers and actions as parameters:
+
+.. code-block:: php
+
+    <?php
+
+    $params = array('posts' => Posts::find());
+
+    // Phalcon\Mvc\View
+    $view = new \Phalcon\Mvc\View();
+    echo $view->render('posts', 'show', $params);
+
+    // Phalcon\Mvc\View\Simple
+    $simpleView = new \Phalcon\Mvc\View\Simple();
+    echo $simpleView->render('posts/show', $params);
+
 Using Partials
 --------------
 Partial templates are another way of breaking the rendering process into simpler more manageable chunks that can be reused by different

ja/reference/micro.rst

@@ -637,6 +637,32 @@ Micro\\MVCを使用した中規模アプリケーションでは、コントロ
 
     });
 
+Please note that this code block uses :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` which uses relative paths instead of controllers and actions.
+If you would like to use :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` instead, you will need to change the parameters of the :code:`render()` method:
+
+.. code-block:: php
+
+    <?php
+
+    $app = new Phalcon\Mvc\Micro();
+
+    $app['view'] = function () {
+        $view = new \Phalcon\Mvc\View();
+        $view->setViewsDir('app/views/');
+        return $view;
+    };
+
+    // Return a rendered view
+    $app->get('/products/show', function () use ($app) {
+
+        // Render app/views/products/show.phtml passing some variables
+        echo $app['view']->render('products', 'show', array(
+            'id'   => 100,
+            'name' => 'Artichoke'
+        ));
+
+    });
+
 Error Handling
 --------------
 A proper response can be generated if an exception is raised in a micro handler:

ja/reference/views.rst

@@ -539,6 +539,22 @@ To render a view it's necessary to call the render method explicitly indicating
         }
     }
 
+This is different to :doc:`Phalcon\\Mvc\\View <../api/Phalcon_Mvc_View>` who's :code:`render()` method uses controllers and actions as parameters:
+
+.. code-block:: php
+
+    <?php
+
+    $params = array('posts' => Posts::find());
+
+    // Phalcon\Mvc\View
+    $view = new \Phalcon\Mvc\View();
+    echo $view->render('posts', 'show', $params);
+
+    // Phalcon\Mvc\View\Simple
+    $simpleView = new \Phalcon\Mvc\View\Simple();
+    echo $simpleView->render('posts/show', $params);
+
 パーシャルの使用
 --------------
 Partial templates are another way of breaking the rendering process into simpler more manageable chunks that can be reused by different

pl/reference/micro.rst

@@ -639,6 +639,32 @@ Rendering Views
 
     });
 
+Please note that this code block uses :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` which uses relative paths instead of controllers and actions.
+If you would like to use :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` instead, you will need to change the parameters of the :code:`render()` method:
+
+.. code-block:: php
+
+    <?php
+
+    $app = new Phalcon\Mvc\Micro();
+
+    $app['view'] = function () {
+        $view = new \Phalcon\Mvc\View();
+        $view->setViewsDir('app/views/');
+        return $view;
+    };
+
+    // Return a rendered view
+    $app->get('/products/show', function () use ($app) {
+
+        // Render app/views/products/show.phtml passing some variables
+        echo $app['view']->render('products', 'show', array(
+            'id'   => 100,
+            'name' => 'Artichoke'
+        ));
+
+    });
+
 Error Handling
 --------------
 A proper response can be generated if an exception is raised in a micro handler:

pl/reference/views.rst

@@ -539,6 +539,22 @@ To render a view it's necessary to call the render method explicitly indicating
         }
     }
 
+This is different to :doc:`Phalcon\\Mvc\\View <../api/Phalcon_Mvc_View>` who's :code:`render()` method uses controllers and actions as parameters:
+
+.. code-block:: php
+
+    <?php
+
+    $params = array('posts' => Posts::find());
+
+    // Phalcon\Mvc\View
+    $view = new \Phalcon\Mvc\View();
+    echo $view->render('posts', 'show', $params);
+
+    // Phalcon\Mvc\View\Simple
+    $simpleView = new \Phalcon\Mvc\View\Simple();
+    echo $simpleView->render('posts/show', $params);
+
 Using Partials
 --------------
 Partial templates are another way of breaking the rendering process into simpler more manageable chunks that can be reused by different

pt/reference/micro.rst

@@ -639,6 +639,32 @@ Rendering Views
 
     });
 
+Please note that this code block uses :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` which uses relative paths instead of controllers and actions.
+If you would like to use :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` instead, you will need to change the parameters of the :code:`render()` method:
+
+.. code-block:: php
+
+    <?php
+
+    $app = new Phalcon\Mvc\Micro();
+
+    $app['view'] = function () {
+        $view = new \Phalcon\Mvc\View();
+        $view->setViewsDir('app/views/');
+        return $view;
+    };
+
+    // Return a rendered view
+    $app->get('/products/show', function () use ($app) {
+
+        // Render app/views/products/show.phtml passing some variables
+        echo $app['view']->render('products', 'show', array(
+            'id'   => 100,
+            'name' => 'Artichoke'
+        ));
+
+    });
+
 Error Handling
 --------------
 A proper response can be generated if an exception is raised in a micro handler:

pt/reference/views.rst

@@ -539,6 +539,22 @@ To render a view it's necessary to call the render method explicitly indicating
         }
     }
 
+This is different to :doc:`Phalcon\\Mvc\\View <../api/Phalcon_Mvc_View>` who's :code:`render()` method uses controllers and actions as parameters:
+
+.. code-block:: php
+
+    <?php
+
+    $params = array('posts' => Posts::find());
+
+    // Phalcon\Mvc\View
+    $view = new \Phalcon\Mvc\View();
+    echo $view->render('posts', 'show', $params);
+
+    // Phalcon\Mvc\View\Simple
+    $simpleView = new \Phalcon\Mvc\View\Simple();
+    echo $simpleView->render('posts/show', $params);
+
 Using Partials
 --------------
 Partial templates are another way of breaking the rendering process into simpler more manageable chunks that can be reused by different

ru/reference/micro.rst

@@ -643,6 +643,32 @@ To access the HTTP method data `$app` needs to be passed into the closure:
 
     });
 
+Please note that this code block uses :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` which uses relative paths instead of controllers and actions.
+If you would like to use :doc:`Phalcon\\Mvc\\View\\Simple <../api/Phalcon_Mvc_View_Simple>` instead, you will need to change the parameters of the :code:`render()` method:
+
+.. code-block:: php
+
+    <?php
+
+    $app = new Phalcon\Mvc\Micro();
+
+    $app['view'] = function () {
+        $view = new \Phalcon\Mvc\View();
+        $view->setViewsDir('app/views/');
+        return $view;
+    };
+
+    // Return a rendered view
+    $app->get('/products/show', function () use ($app) {
+
+        // Render app/views/products/show.phtml passing some variables
+        echo $app['view']->render('products', 'show', array(
+            'id'   => 100,
+            'name' => 'Artichoke'
+        ));
+
+    });
+
 Error Handling
 --------------
 A proper response can be generated if an exception is raised in a micro handler:

ru/reference/views.rst

@@ -527,6 +527,22 @@ If we had used :code:`$this->view->setTemplateBefore('common')`, this would be t
         }
     }
 
+This is different to :doc:`Phalcon\\Mvc\\View <../api/Phalcon_Mvc_View>` who's :code:`render()` method uses controllers and actions as parameters:
+
+.. code-block:: php
+
+    <?php
+
+    $params = array('posts' => Posts::find());
+
+    // Phalcon\Mvc\View
+    $view = new \Phalcon\Mvc\View();
+    echo $view->render('posts', 'show', $params);
+
+    // Phalcon\Mvc\View\Simple
+    $simpleView = new \Phalcon\Mvc\View\Simple();
+    echo $simpleView->render('posts/show', $params);
+
 Части шаблонов (Partials)
 -------------------------
 Части шаблонов (Partial templates) — это ещё один способ дробления процесса отрисовки на более простые части, которые впоследствии могут быть использованы в различных частях приложения. С помощью них можно вынести код отрисовки какой-то конкретной части шаблона в отдельный файл.