Active Record hierarchical SEO categories and tags for Yii2 framework ¶

1. Table of contents
2. Goal
3. or `slug` fields and they will not appear in the web form of creating/editing SEO category
4. Installing

Русская версия

Table of contents ¶

• Goal
• Demo
• Installing
• Module settings

Goal ¶

This extension gives you a variation of categories module, in which the opportunity to create any your own `Active Record` category models was given.

We suggest that when creating pages at frontend to display associated content of the category (or tag) we would need to manage SEO information of such category page.

Respectively we add next fields to our SEO category `Active Record` model:

With all this in module's settings you may choose not to use `meta_other`

or `slug` fields and they will not appear in the web form of creating/editing SEO category ¶

Installing ¶

Installing through composer: ¶

The preferred way to install this extension is through composer.:

Either run composer require --prefer-dist mgrechanik/yii2-seo-categories

or add "mgrechanik/yii2-seo-categories" : "~1.0.0" to the require section of your composer.json

Migrations ¶

This extension comes with two migrations:

• the first creates SEO categories table with all indexes needed
• the second creates unique index for `slug` field

You can run both of them:

php yii migrate --migrationPath=@vendor/mgrechanik/yii2-seo-categories/src/console/migrations

, or when you do not use `slug` field run only the first migration:

php yii migrate 1 --migrationPath=@vendor/mgrechanik/yii2-seo-categories/src/console/migrations

Setting the module up ¶

As was mentioned in the basic categories module, this module follows the approach of universal module, and since it gives you only backend pages when you set it up into your application specify the next `mode:php

'modules' => [
    'seocategory' => [
        'class' => 'mgrechanik\yii2seocategory\Module',
        'mode' => 'backend',
        // Other module settings
    ],
    // ...
],

Done. When you access ```/seocategory``` page you will see all your SEO categories in a form of tree.

---

## Module settings <span id="settings"></span>

[Setting up](#setup) the module into application, along with all properties of the [base categories module](https://github.com/mgrechanik/yii2-categories-and-tags#settings), we can use it's next properties:

#### ```$useMetaOtherField = false``` 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- Whether to use ```other meta tags``` field

#### ```$useSlugField = true``` 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- Whether to use ```slug``` field. It is supposed to be unique

#### ```$slugPattern``` 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- When we use previous field in this property we set up regular expression of expected symbols 

#### ```$showTitleColumnAtIndexPage = true```
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- Whether to display ```title``` field in the categories list grid

#### ```$showSlugColumnAtIndexPage = false``` 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- Whether to display ```slug``` field in the categories list grid