包简介

Taggable symfony bundle

README 文档

README

Bundle provides integration of doctrine-extensions-taggable, adds form types for editing tag and tagging.

Installation

Install via composer with command:

$ php composer.phar require 'anh/taggable-bundle:~1.0'

Enable bundles in the kernel:

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Sp\BowerBundle\SpBowerBundle(),
        new Anh\TaggableBundle\AnhTaggableBundle()
    );

    // ...
}

Install dependencies:

$ app/console sp:bower:install

Bundle uses SpBowerBundle for manage external assets, so installed bower is required.

Update schema:

$ app/console doctrine:schema:update --force

Example

Building form

    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        // ...
        $builder
            ->add('tags', 'tags', array(
                'tagit' => array(/* ... */), // see https://github.com/hilobok/tag-it for available options, may be empty
                'autocomplete' => 'dynamic' // default
            ))
        ;
        // ...
    }

autocomplete option:

dynamic - tags fetched dynamically via ajax (you may set custom url in ['tagit']['autocomplete']['source']) (limited to 100 tags)
static - all tags passed via attribute (limited to 100 tags)
custom - no tags will be provided from db (custom list of tags may be passed by setting ['tagit']['availableTags'])

Rendering form

<!doctype html>
<html>
<head>
    <link rel="stylesheet" href="//ajax.googleapis.com/ajax/libs/jqueryui/1.10.4/themes/smoothness/jquery-ui.css" />
    {% stylesheets
        '@anh_taggable_css'
    %}<link rel="stylesheet" href="{{ asset_url }}" />{% endstylesheets %}

    <script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script>
    <script src="//ajax.googleapis.com/ajax/libs/jqueryui/1.10.4/jquery-ui.min.js"></script>
    {% javascripts
        '@anh_taggable_js'
    %}<script src="{{ asset_url }}"></script>{% endjavascripts %}
</head>
<body>
    {{ form(form) }}
</body>
</html>

Note

Bundle automatically adds mapping for Tag and Tagging entities from doctrine-extensions-taggable. If you for any reason have to disable it put in config.yml:

doctrine:
    orm:
        mappings:
            anh_taggable: { mapping: false }

anh/taggable-bundle 适用场景与选型建议

anh/taggable-bundle 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 12.62k 次下载、GitHub Stars 达 6，最近一次更新时间为 2013 年 10 月 15 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 anh/taggable-bundle 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 anh/taggable-bundle 我们能提供哪些服务？

定制开发 / 二次开发

基于 anh/taggable-bundle 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

anh/taggable-bundle

包简介