muffin / hits
Hits (view) counter for CakePHP 3 ORM.
Installs: 150
Dependents: 0
Suggesters: 0
Security: 0
Stars: 6
Watchers: 4
Forks: 6
Type:cakephp-plugin
Requires
- cakephp/orm: 3.*
Requires (Dev)
- cakephp/cakephp: ~3.0
- cakephp/cakephp-codesniffer: 2.*
- phpunit/phpunit: 4.1.*
This package is auto-updated.
Last update: 2024-10-28 01:08:02 UTC
README
Hits (view) counter for CakePHP 3 ORM.
Install
Using Composer:
composer require muffin/hits:1.0.x-dev
You then need to load the plugin. You can use the shell command:
bin/cake plugin load Muffin/Hits
or by manually adding statement shown below to bootstrap.php
:
Plugin::load('Muffin/Hits');
Usage
Setting up the behavior is similar to the CounterCacheBehavior
in the sense that it takes
a list of fields as configuration. The field name could belong to the current table or to
another table (i.e. view_count
or OtherTable.posts_view_count
).
$this->addBehavior('Muffin/Hits.Hits', ['view_count']);
Or more than just one field, the other one based on certain conditions:
$this->addBehavior('Muffin/Hits.Hits', [ // count only if the post is published 'view_count' => ['is_published' => true], // count all views 'total_view_count' ]);
Or based on certain options passed to the Model.beforeFind
event (i.e. authenticated user):
$this->addBehavior('Muffin/Hits.Hits', [ // count only if the user viewing it is not an admin 'view_count' => function (\Cake\ORM\Query $query, \ArrayObject $options, $counter) { return !isset($options['_footprint']) || $options['_footprint']->is_admin === false; }, // count all views 'total_view_count' ]);
You could also define the value to increment the counter by (defaults to 1
):
$this->addBehavior('Muffin/Hits.Hits', [ 'view_count' => ['increment' => 2] ]);
To use them all at once:
$this->addBehavior('Muffin/Hits.Hits', [ 'view_count' => [ 'conditions' => ['is_published' => true], 'callback' => function (\Cake\ORM\Query $query, \ArrayObject $options, $counter) { return !isset($options['_footprint']) || $options['_footprint']->is_admin === false; }, 'increment' => 2, ], 'total_view_count' ]);
Strategies
Different strategies for keeping track of counts are made available.
DefaultStrategy(array $conditions = [], $offset = 1) (default)
This strategy, while maybe slow for some use cases, is the most widely used. It is also the only one that allows for extra conditions to be passed. Will hit the database on every increment operation.
CacheStrategy(CacheEngine $cache, $threshold = 100, $offset = 1)
This strategy is to be used for the most used counters. It will cache the counts by intervals and hit the database only once it hits the threshold.
SamplingStrategy(StrategyInterface $strategy, $size = 100)
To hit the database the lease and if precise numbers are not an issue, a common strategy used by big
sites is called sampling. It relies on a sample size to generate a random number before triggering
the increment
method on the strategy it wraps (which should have its threshold multiplied by the
sample size).
Patches & Features
- Fork
- Mod, fix
- Test - this is important, so it's not unintentionally broken
- Commit - do not mess with license, todo, version, etc. (if you do change any, bump them into commits of their own that I can ignore when I pull)
- Pull request - bonus point for topic branches
To ensure your PRs are considered for upstream, you MUST follow the CakePHP coding standards.
Bugs & Feedback
http://github.com/usemuffin/hits/issues
License
Copyright (c) 2015, Use Muffin and licensed under The MIT License.