innoweb/silverstripe-metacounter

Adds a counter to the meta fields for remaining characters

Installs: 1 494

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 4

Forks: 1

Open Issues: 0

Language:JavaScript

Type:silverstripe-vendormodule

3.0.0 2023-03-15 03:25 UTC

This package is auto-updated.

Last update: 2024-03-15 05:44:27 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 5.x

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

Installation

Install the module using composer:

composer require innoweb/silverstripe-metacounter dev-master

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