ダッシュボードにカスタム要素を表示するには、SonataAdminはSonataBlockBundleを使用します。カスタムリンクまたはボタンを追加するには、SonataBlockBundleを使用して新しいブロックを作成する必要があります。Admin Bundleのコアテンプレート(dashboard.html.twig)は、(アプリケーションのconfig.ymlで)実行するように構成されたブロックを繰り返します。それでも、AdminBundleはテンプレートblock_admin_list.html.twig内のすべてのエンティティブロックを繰り返します。カスタムブロックテンプレートを作成すると、ここからレイアウトを使用してカスタムグループ(セクション)とボタンをラップし、エンティティグループと同じ感覚にすることができます。
さて、紹介でした。
たとえば、カスタムニュースレターセクションを作成したいとします。
手順があります:
- BlockBundleInterfaceを実装する新しいブロッククラスを作成します
- 新しいブロックテンプレートを作成する
- ブロックサービスを作成する(Symfony 2ライブラリのサービスとは何かを読んで理解する)
- 新しく作成されたサービスをSonataBlockBundle構成に追加します
- 新しく作成されたサービスをSonataAdminBundle構成に追加します
- ダッシュボードに入り、新しいグループ/ボタン/リンク/whatever-stuff-you-put-in-your-block-templateをお楽しみください:)
Ad1)新しいブロッククラスを作成する
一般的な手順:http ://sonata-project.org/bundles/block/master/doc/reference/your_first_block.html
私のファイルは次のようになります。
<?php
namespace InstitutoStorico\Bundle\NewsletterBundle\Block;
use Symfony\Component\HttpFoundation\Response;
use Sonata\AdminBundle\Form\FormMapper;
use Sonata\AdminBundle\Validator\ErrorElement;
use Sonata\BlockBundle\Model\BlockInterface;
use Sonata\BlockBundle\Block\BaseBlockService;
class NewsletterBlockService extends BaseBlockService
{
public function getName()
{
return 'My Newsletter';
}
public function getDefaultSettings()
{
return array();
}
public function validateBlock(ErrorElement $errorElement, BlockInterface $block)
{
}
public function buildEditForm(FormMapper $formMapper, BlockInterface $block)
{
}
public function execute(BlockInterface $block, Response $response = null)
{
// merge settings
$settings = array_merge($this->getDefaultSettings(), $block->getSettings());
return $this->renderResponse('InstitutoStoricoNewsletterBundle:Block:block_my_newsletter.html.twig', array(
'block' => $block,
'settings' => $settings
), $response);
}
}
SonataMediaBundleコードファイルを読み取る行をいくつか追加しました。
Ad2)新しいブロックテンプレートを作成する
SonataAdminバンドルのblock_admin_list.html.twigから取得したレイアウト。
私のファイルは次のようになります。
{% extends 'SonataBlockBundle:Block:block_base.html.twig' %}
{% block block %}
<table class="table table-bordered table-striped sonata-ba-list">
<thead>
<tr>
<th colspan="3">Newsletter - inviare</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<div class="btn-group" align="center">
<a class="btn btn-small" href="#">Servizio Newsletter</a>
</div>
</td>
</tr>
</tbody>
</table>
{% endblock %}
Ad3)ブロックサービスを作成する
バンドルには、サービスを宣言するファイル(services.ymlまたはadmin.yml)があります。なんでもいい。ただし、「インポート」セクションでアプリケーションのconfig.ymlにプラグインすることが重要です。
私のサービス宣言は次のようになります。
sonata.block.service.newsletter:
class: InstitutoStorico\Bundle\NewsletterBundle\Block\NewsletterBlockService
arguments: [ "sonata.block.service.newsletter", @templating ]
tags:
- { name: sonata.block }
Ad4)新しく作成されたサービスをSonataBlockBundle構成に追加します
この構成は、アプリケーションのconfig.ymlに配置されます。
私の設定は次のようになります:
#Sonata Block Bundle
sonata_block:
default_contexts: [cms]
blocks:
sonata.admin.block.admin_list:
contexts: [admin]
sonata.block.service.text: ~
sonata.block.service.action: ~
sonata.block.service.rss: ~
sonata.block.service.newsletter: ~
Ad5)新しく作成されたサービスをSonataAdminBundle構成に追加します
この構成は、アプリケーションのconfig.ymlに配置されます。
私の設定は次のようになります:
# Sonata Admin Generator
sonata_admin:
...
dashboard:
blocks:
# display a dashboard block
- { position: left, type: sonata.admin.block.admin_list }
- { position: left, type: sonata.block.service.newsletter}
Ad6)ダッシュボードに入り、お楽しみください
それで全部です。複雑そうに見えますが、誠実に言うとそれほどではありません。テンプレート全体を上書きせずにダッシュボードページを変更するクリーンな方法であることが重要です。それらすべてのIlは、AdminBundleのソースコードを読むことを学びました:)一日中