arg / tagcloud
PHP Tag Cloud composer package Implementation of http://lotsofcode.github.io/tag-cloud/
Installs: 1 934
Dependents: 2
Suggesters: 0
Security: 0
Stars: 9
Watchers: 3
Forks: 8
Open Issues: 1
Requires
- php: >=5.3.0
- illuminate/support: ~4
This package is not auto-updated.
Last update: 2024-09-24 04:04:46 UTC
README
PHP Tag Cloud composer package Implementation of http://lotsofcode.github.io/tag-cloud/
PHP Tag Cloud
v4.0
Basic usage
$cloud = new TagCloud();
$cloud->addTag("tag-cloud");
$cloud->addTag("programming");
echo $cloud->render();
Convert a string
$cloud->addString("This is a tag-cloud script, written by Del Harvey. I wrote this tag-cloud class because I just love writing code.");
Adding multiple tags
$cloud->addTags(array('tag-cloud','php','github'));
Removing a tag
$cloud->setRemoveTag('github');
Removing multiple tags
$cloud->setRemoveTags(array('del','harvey'));
More complex adding
$cloud->addTag(array('tag' => 'php', 'url' => 'http://www.php.net', 'colour' => 1));
$cloud->addTag(array('tag' => 'ajax', 'url' => 'http://www.php.net', 'colour' => 2));
$cloud->addTag(array('tag' => 'css', 'url' => 'http://www.php.net', 'colour' => 3));
Set the minimum length required
$cloud->setMinLength(3);
Limiting the output
$cloud->setLimit(10);
Set the order
$cloud->setOrder('colour','DESC');
Set a custom HTML output
$cloud->setHtmlizeTagFunction( function($tag, $size) {
$link = '<a href="'.$tag['url'].'">'.$tag['tag'].'</a>';
return "<span class='tag size{$size} colour-{$tag['colour']}'>{$link}</span> ";
});
Outputting the cloud (shown above)
echo $cloud->render();
More usages on in a prettier format can be found here: http://lotsofcode.github.com/tag-cloud
Tests
To run the unit test suite:
cd tests
curl -s https://getcomposer.org/installer | php
php composer.phar install
./vendor/bin/phpunit lotsofcode/TagCloud/TagCloud.php
Submitting pull requests
Indentation style, size and encoding should be followed as per .editorconfig settings.