jbouzekri / sculpin-tag-cloud-bundle
Generate tag cloud in Sculpin
Installs: 325
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 1
Forks: 1
Open Issues: 0
Type:sculpin-bundle
This package is auto-updated.
Last update: 2024-10-12 19:49:34 UTC
README
This bundle generates a tag cloud in sculpin.
You can see a working demo on the right column of my personal french blog.
Installation
Using composer, add the dependancy to your composer.json :
require: { "jbouzekri/sculpin-tag-cloud-bundle": "1.*" }
And run the composer update command
Enable the bundle. If you have already have an app/SculpinKernel.php, add this bundle to it otherwise create the file with the following content :
<?php class SculpinKernel extends \Sculpin\Bundle\SculpinBundle\HttpKernel\AbstractKernel { protected function getAdditionalSculpinBundles() { return array( 'Jb\Bundle\TagCloudBundle\JbTagCloudBundle' ); } }
Then you need to add the tag cloud template and its stylesheets to your project
- Copy the Resources/views/tag_cloud.html file in the _includes folder of your source
- Copy the Resources/public/css/tag_cloud.css file in the css folder of your source (or you can directly add its content in your project stylesheets).
Usage
In a template, you can now call the following twig function :
{{ tag_cloud() }}
It will generate the html tag cloud.
You can specify a custom template :
{{ tag_cloud('my_template.html') }}
Configuration
jb_tag_cloud: tag_permalink: /tags/:taxon/index.html tag_entity: Jb\Bundle\TagCloudBundle\Model\Tag tag_cloud_entity: Jb\Bundle\TagCloudBundle\Model\TagCloud max_number: 0 strategies: - jb_sculpin.tag_cloud.strategy.shuffle - jb_sculpin.tag_cloud.strategy.percent_size
- jb_tag_cloud.tag_permalink : the pattern used for the url in the tag_cloud twig helper
- jb_tag_cloud.tag_entity : the tag entity
- jb_tag_cloud.tag_cloud_entity : the tag cloud entity
- jb_tag_cloud.strategies : A list of services to manipulate the tag cloud. By default, shuffle randomize the order of the tags and percent_size calculate the tag weight based on its number of apparition.
- jb_tag_cloud.max_number : used when enabling the strategy jb_sculpin.tag_cloud.strategy.max_number which will limit the number of tags to display in the cloud (if 0, all tags are displayed). This is global and will be applied to all tag clouds.
- jb_tag_cloud.alpha: Used to display tags in alphabetical order. Can be combined with percent_size
License
This bundle was inspired by the tag-cloud library from lotsofcode