The architecture of the SonataAdminBundle is primarily inspired by the Django Admin Project, which is truly a great project. More information can be found at the Django Project Website.
このバンドルのアーキテクチャーは、主にDjango Admin Project にインスパイアされており、 それはとても大きなプロジェクトです。より多くの情報はDjango ProjectのWebサイトから手に入ります。
The Admin class represents the CRUD definition for a specific model. It contains all the configuration necessary to display a rich CRUD interface for the entity.
Adminクラスは個々のモデルに対してCRUD定義を表します。それ(Adminクラス)はEntityに対して リッチなCRUDインターフェースを表示するために必要な設定を全て含んでいます。
Within the admin class, the following information can be defined:
Adminクラス内部で、以下の情報を定義することができます。
If a field is associated with another entity (and that entity also has an Admin class), then the related Admin class will be accessible from within the first class.
もしフィールドが他のエンティティと関連性がある場合、（そしてそのエンティティもAdminクラスを もっている場合）関連したAdminクラスは一つ目のクラス内で利用しやすいようになります。
The admin class is a service implementing the AdminInterface interface, meaning that the following required dependencies are automatically injected:
adminクラスは AdminInterface インターフェースを実装しているサービスであり、 以下の必須依存関係が自動的に注入されることを意味しています。
Therefore, you can gain access to any service you want by injecting them into the admin class, like so:
それゆえ、Adminクラス内に注入することによってあなたが望むどんなサービスでもアクセスすることが できます。以下のように。
<service id="sonata.news.admin.post" class="%sonata.news.admin.post.class%">
<tag name="sonata.admin" manager_type="orm" group="sonata_blog" label="post"/>
<argument />
<argument>%sonata.news.admin.post.entity%</argument>
<argument>%sonata.news.admin.post.controller%</argument>
<call method="setUserManager">
<argument type="service" id="fos_user.user_manager" />
</call>
</service>
Here, the FOS’ User Manager is injected into the Post service.
ここでは、FOS’ User Manager はPostサービスに注入されています。
A field definition is a FieldDescription object. There is one definition per list field.
フィールド定義は FieldDescription オブジェクト。リストフィールドごとに一つの定義があります。
The definition contains:
この定義は以下を含んでいます
The current implementation uses Twig as the template engine. All templates are located in the Resources/views/CRUD directory of the bundle. The base template extends two layouts:
The base templates can be configured in the Service Container. So you can easily tweak the layout to suit your requirements.
ベーステンプレートはサービスコンテナで設定することができます。ですので、簡単に 要求に適したレイアウトに調整することができます。
Each field is rendered in three different ways and each has its own Twig template. For example, for a field with a text type, the following three templates will be used:
それぞれのフィールドは３つの異なった方法で描画され、それぞれが自身のTwigテンプレートを持って います。例えば、 text タイプのフィールドは、以下の３つのテンプレートが使われています。
The controller contains the basic CRUD actions. It is related to one Admin class by mapping the controller name to the correct Admin instance. このコントローラーは基本的なCRUDアクションを含んでおり、コントローラーは 同一名のAdminインスタンスにマッピングされることにより、１つのAdminクラスに関連付けられます。
Any or all actions can be overwritten to suit the project’s requirements. いくつか、もしくは全てのアクションはプロジェクトの要求に合わせて上書きすることができます。
The controller uses the Admin class to construct the different actions. Inside the controller, the Admin object is accessible through the configuration property. コントローラーは異なるアクションを構成するためにAdminクラスを使います。 コントローラー内部では、Adminオブジェクトはコンフィギュレーションプロパティを通してアクセスすることができます。
Admin definitions are accessible through the sonata.admin.pool service or directly from the DIC (dependency injection container). The Admin definitions are lazy-loaded from the DIC to reduce overhead.
Once you have created an admin class, you need to make the framework aware of it. To do that, you need to add a tag with the name sonata.admin to the service. Parameters for that tag are:
Adminクラスを作ったときには、フレームワークにそれを気づかせなければなりません。 すべきことは、サービスのタグのnameに sonata.admin を加えます。 タグのパラメータは次の通りです。
Examples:
<!-- app/config/config.xml -->
<service id="sonata.news.admin.post" class="Sonata\NewsBundle\Admin\PostAdmin">
<tag name="sonata.admin" manager_type="orm" group="sonata_blog" label="post"/>
<argument />
<argument>Sonata\NewsBundle\Entity\Post</argument>
<argument>SonataAdminBundle:CRUD</argument>
</service>
If you want to define your own controller for handling CRUD operations, change the last argument in the service definition to:
もし自身のコントローラーでCRUD操作をハンドリングしたければ、サービス定義の最後の引数を変更してください。
<argument>SonataNewsBundle:PostAdmin</argument>
Or if you’re using a YML configuration file,
もしYML設定ファイルを使っているなら以下
services:
sonata.news.admin.post:
class: Sonata\NewsBundle\Admin\PostAdmin
tags:
- { name: sonata.admin, manager_type: orm, group: sonata_blog, label: post }
arguments: [null, Sonata\NewsBundle\Entity\Post, SonataNewsBundle:PostAdmin]
You can extend Sonata\AdminBundle\Admin\Admin class to minimize the amount of code to write. This base admin class uses the routing services to build routes. Note that you can use both the Bundle:Controller format or a service name to specify what controller to load.
書かなければならないコードを最小化するために Sonata\AdminBundle\Admin\Admin を継承することができます。 このベースAdminはルートを作るためルーディングサービスを使用します。 どのコントローラーをロードすべきか特定する為に Bundle:Controllerフォーマットと、 service name の両方を使うことができることに注意しましょう。