Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
Y
yii2
Project
Overview
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
PSDI Army
yii2
Commits
f11ecb94
Commit
f11ecb94
authored
Aug 16, 2013
by
Alexander Makarov
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
more docs on views, cross-references, intros for error handling and debugger
parent
805706b2
Hide whitespace changes
Inline
Side-by-side
Showing
7 changed files
with
76 additions
and
12 deletions
+76
-12
debugger.md
docs/guide/debugger.md
+8
-2
error.md
docs/guide/error.md
+4
-0
form.md
docs/guide/form.md
+3
-0
index.md
docs/guide/index.md
+1
-1
security.md
docs/guide/security.md
+7
-2
upgrade-from-v1.md
docs/guide/upgrade-from-v1.md
+7
-3
view.md
docs/guide/view.md
+46
-4
No files found.
docs/guide/debugger.md
View file @
f11ecb94
Debug toolbar and debugger
Debug toolbar and debugger
==========================
==========================
Overview
Yii2 includes a handy toolbar to aid faster development and debugging as well as debugger. Toolbar displays information
--------
about currently opened page while using debugger you can analyze data collected before.
Installing and configuring
--------------------------
How to use it
-------------
Creating your own panels
Creating your own panels
------------------------
------------------------
...
...
docs/guide/error.md
View file @
f11ecb94
Error Handling
Error Handling
==============
==============
Error handling in Yii is different from plain PHP. First of all, all non-fatal errors are converted to exceptions so
you can use
`try`
-
`catch`
to work with these. Second, even fatal errors are rendered in a nice way. In debug mode that
means you have a trace and a piece of code where it happened so it takes less time to analyze and fix it.
docs/guide/form.md
View file @
f11ecb94
Working with forms
==================
docs/guide/index.md
View file @
f11ecb94
...
@@ -67,7 +67,7 @@ More
...
@@ -67,7 +67,7 @@ More
====
====
-
[
Bootstrap widgets
](
bootstrap-widgets.md
)
-
[
Bootstrap widgets
](
bootstrap-widgets.md
)
-
[
Form
](
form.md
)
-
[
Working with forms
](
form.md
)
-
[
Model validation reference
](
validation.md
)
-
[
Model validation reference
](
validation.md
)
-
[
Caching
](
caching.md
)
-
[
Caching
](
caching.md
)
-
[
Internationalization
](
i18n.md
)
-
[
Internationalization
](
i18n.md
)
...
...
docs/guide/security.md
View file @
f11ecb94
...
@@ -78,4 +78,10 @@ Securing Cookies
...
@@ -78,4 +78,10 @@ Securing Cookies
----------------
----------------
-
validation
-
validation
-
httpOnly
-
httpOnly
\ No newline at end of file
See also
--------
-
[
Views security
](
view.md#security
)
docs/guide/upgrade-from-v1.md
View file @
f11ecb94
...
@@ -149,11 +149,12 @@ $content = Yii::$app->view->renderFile($viewFile, $params);
...
@@ -149,11 +149,12 @@ $content = Yii::$app->view->renderFile($viewFile, $params);
Also, there is no more
`CClientScript`
in Yii 2.0. The
`View`
class has taken over its role
Also, there is no more
`CClientScript`
in Yii 2.0. The
`View`
class has taken over its role
with significant improvements. For more details, please see the "assets" subsection.
with significant improvements. For more details, please see the "assets" subsection.
While Yii 2.0 continues to use PHP as its main template language, it comes with
built-in
While Yii 2.0 continues to use PHP as its main template language, it comes with
two official extensions
support for two popular template engines: Smarty and Twig. The Prado template engine is
adding
support for two popular template engines: Smarty and Twig. The Prado template engine is
no longer supported. To use these template engines, you just need to use
`tpl`
as the file
no longer supported. To use these template engines, you just need to use
`tpl`
as the file
extension for your Smarty views, or
`twig`
for Twig views. You may also configure the
extension for your Smarty views, or
`twig`
for Twig views. You may also configure the
`View::renderers`
property to use other template engines.
`View::renderers`
property to use other template engines. See
[
Using template engines
](
template.md
)
section
of the guide for more details.
Models
Models
...
@@ -209,6 +210,8 @@ Because of the above change, Yii 2.0 no longer has "safe" and "unsafe" validator
...
@@ -209,6 +210,8 @@ Because of the above change, Yii 2.0 no longer has "safe" and "unsafe" validator
If your model only has one scenario (very common), you do not have to overwrite
`scenarios()`
,
If your model only has one scenario (very common), you do not have to overwrite
`scenarios()`
,
and everything will still work like the 1.1 way.
and everything will still work like the 1.1 way.
To learn more about Yii 2.0 models refer to
[
Models
](
model.md
)
section of the guide.
Controllers
Controllers
-----------
-----------
...
@@ -216,6 +219,7 @@ Controllers
...
@@ -216,6 +219,7 @@ Controllers
The
`render()`
and
`renderPartial()`
methods now return the rendering results instead of directly
The
`render()`
and
`renderPartial()`
methods now return the rendering results instead of directly
sending them out. You have to
`echo`
them explicitly, e.g.,
`echo $this->render(...);`
.
sending them out. You have to
`echo`
them explicitly, e.g.,
`echo $this->render(...);`
.
To learn more about Yii 2.0 controllers refer to
[
Controller
](
controller.md
)
section of the guide.
Widgets
Widgets
-------
-------
...
...
docs/guide/view.md
View file @
f11ecb94
...
@@ -37,6 +37,30 @@ Intead of just scalar values you can pass anything else such as arrays or object
...
@@ -37,6 +37,30 @@ Intead of just scalar values you can pass anything else such as arrays or object
Widgets
Widgets
-------
-------
Widgets are a self-contained building blocks for your views. A widget may contain advanced logic, typically takes some
configuration and data and returns HTML. There is a good number of widgets bundled with Yii such as
[
active form
](
form.md
)
,
breadcrumbs, menu or
[
wrappers around bootstrap component framework
](
boostrap-widgets.md
)
. Additionally there are
extensions providing additional widgets such as official one for jQueryUI components.
In order to use widget you need to do the following:
```
php
// Note that you have to "echo" the result to display it
echo
\yii\widgets\Menu
::
widget
(
array
(
'items'
=>
$items
));
// Passing an array to initialize the object properties
$form
=
\yii\widgets\ActiveForm
::
begin
(
array
(
'options'
=>
array
(
'class'
=>
'form-horizontal'
),
'fieldConfig'
=>
array
(
'inputOptions'
=>
array
(
'class'
=>
'input-xlarge'
)),
));
...
form
inputs
here
...
\yii\widgets\ActiveForm
::
end
();
```
In the code above
`widget`
method is used for a widget that just outputs content while
`begin`
and
`end`
are used for a
widget that wraps content between method calls with its own output. In case of the form this output is the
`<form>`
tag
with some properties set.
Security
Security
--------
--------
...
@@ -87,11 +111,11 @@ Alternative template languages
...
@@ -87,11 +111,11 @@ Alternative template languages
There are offlicial extensions for
[
Smarty
](
http://www.smarty.net/
)
and
[
Twig
](
http://twig.sensiolabs.org/
)
. In order
There are offlicial extensions for
[
Smarty
](
http://www.smarty.net/
)
and
[
Twig
](
http://twig.sensiolabs.org/
)
. In order
to learn more refer to
[
Using template engines
](
template.md
)
section of the guide.
to learn more refer to
[
Using template engines
](
template.md
)
section of the guide.
Using View object
Using View object
in templates
-----------------
-----------------
-------------
An instance of
`yii\base\View`
is available in view templates as
`$this`
variable. Using it you can do many useful things
An instance of
`yii\base\View`
component is available in view templates as
`$this`
variable. Using it in templates you
including setting page title and meta, registering scripts and accessing the context.
can do many useful things
including setting page title and meta, registering scripts and accessing the context.
### Setting page title
### Setting page title
...
@@ -314,3 +338,21 @@ echo $this->context->getRoute();
...
@@ -314,3 +338,21 @@ echo $this->context->getRoute();
### Caching blocks
### Caching blocks
To learn about caching of view fragments please refer to
[
caching
](
caching.md
)
section of the guide.
To learn about caching of view fragments please refer to
[
caching
](
caching.md
)
section of the guide.
Customizing View component
--------------------------
Since view is also an application component named
`view`
you can replace it with your own component that extends
from
`yii\base\View`
. It can be done via application configuration file such as
`config/web.php`
:
```
php
return
array
(
// ...
'components'
=>
array
(
'view'
=>
array
(
'class'
=>
'app\components\View'
,
),
// ...
),
);
```
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment