README

alternative way for work with breadcrumbs and metadata with open-graph-protocol helpers

also include NoLayoutBehavior for registration actions where layout must be skipped

👁 Status
👁 Latest Stable Version
👁 Total Downloads
👁 License

Installation

The preferred way to install this extension is through composer.

Either run

composer require --prefer-dist insolita/yii2-metacrumbs "~2.0"

or add

"insolita/yii2-metacrumbs": "~1.0"

to the require section of your composer.json file.

Usage

• register MetaCrumbsBootstrap, or manual register as singleton :

 \Yii::$container->setSingleton(IBreadcrumbCollection::class,BreadCrumbs::class);

and/or

 \Yii::$container->setSingleton(IMetaManager::class,MetaManager::class);

• add widget in layout

 <?= \insolita\metacrumbs\widgets\CrumbWidget::widget([]) ?>

• add CrumbedControllerTrait in base controller (or in needed controllers) and register crumbs
• add MetaManagerTrait in needed controllers or base controller (also in service possible)

Controller Example

class ExampleController extends Controller
{
 use CrumbedControllerTrait;
 use MetaManagerTrait;

 public function actions()
 {
 return [
 'error' => [
 'class' => 'yii\web\ErrorAction',
 ],
 ];
 }

 public function behaviors()
 {
 return [
 'nolayout'=>['class'=>NoLayoutBehavior::class,'actions' => ['ajax']]
 // 'nolayout'=>['class'=>NoLayoutBehavior::class,'actions' => ['index','about'],'except'=>true]

 ];
 }
 public function beforeAction($action)
 {
 $this->registerHomeCrumb();
 $this->registerIndexCrumb('Сайтег');
 if ($action->id == 'error') {
 $this->registerCurrentCrumb('Страница ошибок');
 $this->metaManager()->canonical();
 }
 return parent::beforeAction($action);
 }

 public function actionIndex()
 {
 $this->metaManager()->canonical(Url::to(['example/default']));
 $this->metaManager()->tag('description', 'Bla-bla-la-la-la');
 $this->metaManager()->prop('og:description', 'Bla-bla-bla');
 $this->metaManager()->prop('og:title', 'Bla-bla-bla');
 $this->metaManager()->keywords('Some, keywords,list');
 //Also
 return $this->render('index');
 }
 public function actionView(int $id)
 {
 $this->crumbCollection->addCrumb(
 new CrumbItem('Special crumb', Url::to(['some/page']), 20, ['target' => '_blank'])
 );
 $model = $this->pageFinder->findById($id);
 $this->registerCurrentCrumb($model->title);
 $this->metaManager()->ogMeta($model->title,Url::current([],true),$model->description,$model->cover,'article');
 return $this->render('about',['model'=>$model]);
 }

 ....