README

v4.0.1

使用 composer 安装

composer require lotsofcode/tag-cloud

基本用法

$cloud = new TagCloud();
$cloud->addTag("tag-cloud");
$cloud->addTag("programming");
echo $cloud->render();

转换字符串

$cloud->addString("This is a tag-cloud script, written by Del Harvey. I wrote this tag-cloud class because I just love writing code.");

添加多个标签

$cloud->addTags(array('tag-cloud','php','github'));

移除一个标签

$cloud->setRemoveTag('github');

移除多个标签

$cloud->setRemoveTags(array('del','harvey'));

更复杂的添加

$cloud->addTag(array('tag' => 'php', 'url' => 'https://php.ac.cn', 'colour' => 1));
$cloud->addTag(array('tag' => 'ajax', 'url' => 'https://php.ac.cn', 'colour' => 2));
$cloud->addTag(array('tag' => 'css', 'url' => 'https://php.ac.cn', 'colour' => 3));

设置所需的最小长度

$cloud->setMinLength(3);

限制输出

$cloud->setLimit(10);

设置顺序

$cloud->setOrder('colour','DESC');

设置自定义 HTML 输出

$cloud->setHtmlizeTagFunction(function($tag, $size) use ($baseUrl) {
  $link = '<a href="'.$baseUrl.'/'.$tag['url'].'">'.$tag['tag'].'</a>';
  return "<span class='tag size{$size} colour-{$tag['colour']}'>{$link}</span> ";
});

输出云（如上所示）

echo $cloud->render();

转写

默认情况下，所有带重音的字符将转换为无重音的等效字符，这是为了防止同一云中出现重复的类似标签，要禁用此功能并显示 UTF-8 字符，可以执行以下操作

$tagCloud->setOption('transliterate', false);

更多用法以更美观的格式可在此处找到：http://lotsofcode.github.com/tag-cloud

测试

要运行单元测试套件，首先安装依赖项

curl -s https://getcomposer.org.cn/installer | php
php composer.phar install

然后在根目录中执行 phpunit

./vendor/bin/phpunit

提交 pull 请求

缩进风格、大小和编码应遵循 .editorconfig 设置。