arogozin / tagcloud by arogozin

PHP Tag Cloud composer package Implementation of http://lotsofcode.github.io/tag-cloud/
1,931
9
3
Package Data
Maintainer Username: arogozin
Maintainer Contact: arogozin@nyu.edu (Aleksandr Rogozin)
Package Create Date: 2013-09-16
Package Last Update: 2014-07-11
Language: PHP
License: MIT
Last Refreshed: 2024-03-24 03:00:51
Package Statistics
Total Downloads: 1,931
Monthly Downloads: 0
Daily Downloads: 0
Total Stars: 9
Total Watchers: 3
Total Forks: 8
Total Open Issues: 1

tagcloud

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.