xini/silverstripe-metacounter

This package is abandoned and no longer maintained. The author suggests using the innoweb/silverstripe-metacounter package instead.

Adds a counter to the meta fields for remaining characters

Installs: 315

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 1

Open Issues: 1

Language:JavaScript

Type:silverstripe-module

2.0.0 2018-03-02 08:19 UTC

This package is auto-updated.

Last update: 2019-02-20 19:43:37 UTC


README

Version License

Overview

Adds limit counters to the meta title and description fields in the CMS.

Two levels of limits can be configured to allow longer texts for certain search engines (i.e. Google).

Requirements

  • SilverStripe CMS 4.x

Note: this version is compatible with SilverStripe 4. For SilverStripe 3, please see the 1.1 release line.

Installation

Install the module using composer:

composer require innoweb/silverstripe-metacounter dev-master

or download or git clone the module into a ‘metacounter’ directory in your webroot.

Then run dev/build.

Configuration

The default limits are as follows and can be overridden in your site's config.yml:

Innoweb\MetaCounter\Model\SiteTreeExtension:
  meta_title_length: 55
  meta_title_length_extended: 55
  meta_description_length: 160
  meta_description_length_extended: 300

Once the text exceeds the configured 'length' of a field the counter will turn orange, once it exceeds 'length_extended' it will turn red and count backwards.

If 'length_extended' is not configured or if it is the same as 'length', the counter will turn red if the text exceeds 'length'.

Troubleshooting

Sometimes you may add a MetaTitle field to your Page sub/class, with correct length configurations, but no counter appears.

If you have added the field manually rather than via kinglozzer/metatitle sometimes the Page extension in this module will run before your MetaTitle field is present (and as result there is no field for the counter to attach to).

To protect against this, use beforeUpdateCMSFields() inside your getCMSFields():

public function getCMSFields()
{
    $this->beforeUpdateCMSFields(function(FieldList $fields) {
        $fields->insertBefore(
            'MetaDescription',
            TextField::create('MetaTitle', $this->fieldLabel('MetaTitle'))
        ); 
    });
    
    $fields = parent::getCMSFields();
    // your other class-specific CMS fields setup
    return $fields;
}

License

BSD 3-Clause License, see License