658

Product support

Get help in the plugin support forum.

  • Added on Jan 13, 2021
  • Current version: 1.0.1
  • Platform Compatibility
    v3.x not tested
    v2.x not tested
    v1.x use latest
  • Created by

Categories

Allows to easily create counters and statistics over any model from OctoberCMS, using:

  • Basic incrementation
  • Optional amount of incrementation
  • Bulk incrementation over many models at once
  • Providing a Measurable behavior you can add to any plugin's models from the marketplace See README or documentation section for more informations.

Measures

This plugin allows you to create/increment and display any measures you want on a model, some examples could be:

  • Blog post's views
  • API's resource fetches count
  • ...

Measurable Behavior

You can add the Measurable Behavior (think of it as a Trait) to any model you want using Rain Extension.

Extending existing models from a Plugin registration file:

RainLab\Blog\Models\Post::extend(function ($postModel) {
    $postModel->implement[] = 'SunLab.Measures.Behaviors.Measurable';
});

Or directly to your Plugin's model:

class Link extends Model
{
    public $implement = ['SunLab.Measures.Behaviors.Measurable'];
    //...
}

Create/Increment a measure

Once you've added the Measurable Behavior to a model, you can use the model's method incrementMeasure.

$post->incrementMeasure('views');

// Optional amount of incrementation can be passed
$post->incrementMeasure('views', 5);

// Using the MeasureManager statics helper:
use SunLab\Measures\Classes\MeasureManager;
MeasureManager::incrementMeasure($post, 'views');
MeasureManager::incrementMeasure($post, 'views', 5);

Note: You don't have to process any kind of initialization of the measure, just use it.

Practical example, creating a post views in RainLab.Blog:

title = "Blog post page"
url = "/blog/article/:slug"
layout = "default"
is_hidden = 0

[blogPost]
slug = "{{ :slug }}"
categoryPage = "blog/category"
==
function onEnd() {
    $this->blogPost->post->incrementMeasure('views');
}
==
{% component 'blogPost' %}

Bulk incrementation

You can increment multiple models measure at once, this is useful when you want to measure the amount of models fetches from an API.

// Passing to the MeasureManager a Builder instance
$products = Product::where('name', 'like', '%shoes%');
MeasureManager::incrementMeasure($products, 'appearedInSearchResults');

return new JsonResponse([
    'products' => $products->get()
]);

Displaying a measure

To display the measure from a model, just use the getMeasure method on it. The method returns a Measure model which contains an amount property

// From a backend controller/view
$post = Post::first();
$views = $post->getMeasure('views')->amount;
// From a frontend Twig block
{{ post.getMeasure('view').amount }}

TODO-List:

In a near future, I'll add some feature such as:

  • [ ] Bulk incrementation from a model collection instead of the Builder
  • [ ] Easier access to the amount of a measure using $model->getViewsMeasure()
  • [ ] A ReportWidget displaying some specific measures
1.0.1

First version of SunLab.Measures

Jan 12, 2021