insolita/yii2-metacrumbs

alternative way for work with breadcrumbs and meta

Yii2 meta-crumbs pack

alternative way for work with breadcrumbs and metadata with open-graph-protocol helpers, _(*1)

also include NoLayoutBehavior for registration actions where layout must be skipped, _(*2)

, _(*3)

Installation

The preferred way to install this extension is through composer., _(*4)

Either run, _(*5)

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

or add, _(*6)

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

to the require section of your composer.json file., _(*7)

Usage

• register MetaCrumbsBootstrap, or manual register as singleton :

 \Yii::$container->setSingleton(IBreadcrumbCollection::class,BreadCrumbs::class);
 ```
and/or

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

```, <sub>(*9)</sub>

• add widget in layout, <sub>(*10)</sub>

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

• add CrumbedControllerTrait in base controller (or in needed controllers) and register crumbs, <sub>(*11)</sub>

• add MetaManagerTrait in needed controllers or base controller (also in service possible), <sub>(*12)</sub>

  Controller Example, <sub>(*13)</sub>

  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]);
   }
  
   ....