README

分类

本包允许您在 Laravel 4 和 5 中创建包含术语的词汇表

安装

Laravel 5

在您的 composer.json 中添加

5.0 - 5.1

"require": {
	"devfactory/taxonomy": "3.0.*"
}

5.2+

"require": {
	"devfactory/taxonomy": "3.1.*"
}

从终端运行

composer update

然后打开 app/config/app.php 注册服务提供者和 Facade

'Devfactory\Taxonomy\TaxonomyServiceProvider',

'Taxonomy'        => 'Devfactory\Taxonomy\Facades\TaxonomyFacade',

然后运行以下 artisan 命令以发布配置和迁移

php artisan vendor:publish

然后运行迁移

php artisan migrate

最后，在您希望使用 Taxonomy 功能的任何模型中添加以下特质

<?php

class Car extends \Eloquent {
  use \Devfactory\Taxonomy\TaxonomyTrait;
}

Laravel 4

在您的 composer.json 中添加

"require": {
	"devfactory/taxonomy": "2.0.*"
}

从终端运行

composer update

然后打开 app/config/app.php 注册服务提供者和 Facade

'Devfactory\Taxonomy\TaxonomyServiceProvider',

'Taxonomy'        => 'Devfactory\Taxonomy\Facades\TaxonomyFacade',

如果您想更改它们，可以发布配置文件

php artisan config:publish devfactory/taxonomy

执行数据库迁移以安装所需的表

php artisan migrate --package=devfactory/taxonomy

最后，在您希望使用 Taxonomy 功能的任何模型中添加以下特质

<?php

class Car extends \Eloquent {
  use \Devfactory\Taxonomy\TaxonomyTrait;
}

用法

创建一个词汇表

Taxonomy::createVocabulary('Cars');

检索一个词汇表

$vocabulary = Taxonomy::getVocabulary(1);             // Using ID
$vocabulary = Taxonomy::getVocabularyByName('Cars');  // Using Name

删除一个词汇表

Taxonomy::deleteVocabulary(1);             // Using ID
Taxonomy::deleteVocabularyByName('Cars');  // Using Name

向词汇表中添加一个术语

Taxonomy::createTerm($vocabulary->id, 'Audi');

您还可以选择性地指定每个术语的父术语和权重，以便将它们分组并保持排序

$german_cars = Taxonomy::createTerm($vocabulary->id, 'German Cars');
$italian_cars = Taxonomy::createTerm($vocabulary->id, 'Italian Cars');

$term_audi = Taxonomy::CreateTerm($vocabulary->id, 'Audi', $german_cars->id, 0);
$term_bmw  = Taxonomy::CreateTerm($vocabulary->id, 'BMW', $german_cars->id, 1);
$term_benz = Taxonomy::CreateTerm($vocabulary->id, 'Mercedes-Benz', $german_cars->id, 2);
$term_ferrari = Taxonomy::CreateTerm($vocabulary->id, 'Ferrari', $italian_cars->id, 0);

使用 Car Model，我可以创建一个新的实例并为其分配一个术语

$car = Car::create([
  'model' => 'A3',
]);

$car->addTerm($term_bmw->id);
$car->addTerm($term_benz->id);
$car->removeAllTerms();              // Remove all terms linked to this car

$car->addTerm($term_ferrari->id);
$car->removeTerm($term_ferrari-id);  // Remove a specific term

$car->addTerm($term_audi->id);

// Get all the terms from the vocabulary 'Cars' That
// are attached to this Car.
$terms = $car->getTermsByVocabularyName('Cars');

检索所有与给定术语匹配的汽车

$audis = Car::getAllByTermId($term_audi->id)->get();