fomvasss / laravel-taxonomy
Management of taxonomy in Laravel projects
Installs: 696
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 2
Forks: 1
Open Issues: 0
Type:composer-package
Requires
- php: ^7.1|^8.0
- illuminate/database: 5.7.*|5.8.*|^6.0|^7.0|^8.0|^9.0
- illuminate/support: 5.7.*|5.8.*|^6.0|^7.0|^8.0|^9.0
- kalnoy/nestedset: ^5.0|^6.0
README
Development and support of this package is discontinued! Use a better solution fomvasss/laravel-simple-taxonomy
Laravel Taxonomy
Create and manage taxonomy categories (terms) in Laravel Eloquent.
Установка
composer require fomvasss/laravel-taxonomy
Publishing resources
php artisan vendor:publish --provider="Fomvasss\Taxonomy\TaxonomyServiceProvider"
После публикации ресурсов, вы можете изменить файл миграции, seeder и переопределить Eloquent-модели термов, словарей.
composer dump-autoload php artisan migrate php artisan db:seed --class=TaxonomySeeder
При использовании переопределенных классов моделей терминов и словарей, нужно указать в конфигу
taxonomy.php
пути этих моделей, иначе система будет работать не так как вы планируете!
Usage
Usage in own models
Для использование в ваших моделях таксономии, нужно подключить трейт
HasTaxonomies
в котором есть relation methods & scope`s:
Relations
termsByVocabulary()
- Связь текущей модели с термамы по указанному словарю (поsystem_name
). Используется для создание связей с термамы нужного словаря в своих моделяхterms()
- Сущность текущей модели "относится" к разным термам (полиморфизм), например: товар в магазине относится к разным категориямterm()
- Сущность имеет один терм (ключ для связи создается в таблице текущей сущности), например: экземпляр автомобиля имеет бренд
Scopes
termsByVocabulary()
- Термы текущей модели по указанному словарю (поsystem_name
). Не путать с связьюtermsByVocabulary()
!byTaxonomies()
- Сущности по указанным термам с соответствующих указанных словарей (ключи по умолчанию:vocabulary.system_name
,term.id
)
Можно создавать в своих моделях, свои, более удобные, методы для связей, на основе метода-связи terms()
.
Например: модель статьи Article
относится к разным термам-категориям Term
со словаря (Vocabulary
) "Категории статей" (vocabularies.id
= 1, vocabularies.system_name
= "article_categories") то метод связи между статьей и ее категориями можно назвать txArticleCategories
и записать как:
Удобно строить связь используя метод
termsByVocabulary()
и указывая системное имя нужного словаря:
public function txArticleCategories() { return $this->termsByVocabulary('article_categories'); }
В ваших методах, для связей с таксономией (термины, словари), рекомендуется использовать как стандарт префикс "tx" (
txArticleCategories
,txArticleStatus
,txBrands
txRegion
,...) - это только рекомендация:)
Например, если метод txArticleCategories()
использовать в модели Article
, то он описывает связь статьи с категориямы.
Все категории статьи можно получить:
$article = Models\Article::first()->txArticleCategories;
Аналогично, можно использовать метод term()
в вашей модели. Например, опишем связь статьи с термом словаря статусов модерации статьи,
при этом укажем поля для связей модели терма-статуса с самой моделью статьи:
public function txArticleStatus() { return $this->term('status', 'system_name') ->where('vocabulary', 'article_statuses'); }
где:
txArticleStatus
- название метода для связи сущности-статьи с термом-статусом (можно любое, по правилам Laravel)status
- поле в таблице текущой сущности (статьи), где хранится статус, через которое и установленная связь с термом (articles.status
)system_name
- поле в таблице термов (в нашем случае записано системное имя статуса) (terms.system_name
)vocabulary
- поле в таблице термов, в котором записано систимное название словаря (terms.vocabulary
)article_statuses
- название словаря, записанное в таблице термов (terms.vocabulary
)
Например, если метод txArticleStatus()
использовать в модели Article
, то он описывает статус статьи.
Данные терма-статуса, например имя статуса, можно получить:
$article = \App\Models\Article::first(); $article->txArticleStatus->name;
В переопределенной модели Term
вы можете описать метод, для получения всех статтей по терму-категории:
public function articles() { return $this->morphedByMany(Article::class, 'termable'); }
И использовать его:
Term::byVocabulary('article_categories')->first(13)->articles
Методы в модели Vocabulary
Связи
terms()
- Словарь имет много термов
Полиморфные связи
vocabulariesByMany()
- Сущность текущей модели "держит" много словарейvocabulariesToMany()
- Сущность текущей модели "относится" к разным словарямtermsByMany()
- Сущность текущей модели "держит" много термовtermsToMany()
- Сущность текущей модели "относится" к разным термам
Методи в модели Term
Связи
txVocabulary()
- Терм "пренадлежит" одному словарю
Полиморфные связи
vocabulariesByMany()
- Сущность текущей модели "держит" много словарейvocabulariesToMany()
- Сущность текущей модели "относится" к разным словарямtermsByMany()
- Сущность текущей модели "держит" много термовtermsToMany()
- Сущность текущей модели "относится" к разным термам (илиterms()
с трейтаHasTaxonomies
)
Scopes в модели Term
byVocabulary()
- Все термы по указанному словарю
Работа с иерархией в терминах таксономии (рекомендации)
- Работа с иерархией в этом пакете построена на "laravel-nestedset"
- Для моделей термов доступны все методы пакета
laravel-nestedset
.
Еще примеры использования:
\App\Models\Taxonomy\Term::find(1)->vocabulary; // get system name vocabulary \App\Models\Taxonomy\Term::find(1)->txVocabulary; // get related model vocabulary \App\Models\Taxonomy\Term::byVocabulary('article_categories')->get(); // get terms by system name vocabulary \App\Models\Taxonomy\Term::byVocabulary('article_categories')->get()->toTree(); // `toTree` - method from package `lazychaser/laravel-nestedset` \App\Models\Taxonomy\Term::find(1)->descendants; // `descendants` - method from package `lazychaser/laravel-nestedset` \App\Models\Article::with('txArticleCategories')->get(); // get articles with article categories \App\Models\Article::first()->txArticleCategories()->attach([1, 2]); \App\Models\Article::first()->txArticleCategories()->sync([4, 2]); // this detach all terms in article and sync 4 ,2!!! Same as: \App\Models\Article::first()->terms()->sync([4, 2]); \App\Models\Article::first()->terms()->detach([4]); \App\Models\Article::first()->txArticleCategories()->syncWithoutDetaching([4, 2]); // sync terms without detaching \App\Models\Article::byTaxonomies([ 'article_categories' => [1,3,5], 'cities' => [3] ])->get(); // use for example for filters