Taglet
Taglet allows you to manage tags associated to your records.
It also allows you to specify various contexts
Installation
- Add
taglet
to your list of dependencies inmix.exs
:
def deps do
[{:taglet, "~> 0.2.0"}]
end
- Configure Taglet to use your repo in
config/config.exs
:
config :taglet, repo: ApplicationName.Repo
Install your dependencies:
mix deps.get
Generate the migrations:
mix taglet.install
Run the migrations:
mix ecto.migrate
Include it in your models
Now, you can use the library in your models.
You should add the next line to your taggable model:
use Taglet.TagAs, :tag_context_name
i.e.:
defmodule Post do
use Ecto.Schema
use Taglet.TagAs, :tags
use Taglet.TagAs, :categories
import Ecto.Changeset
schema "posts" do
field :title, :string
field :body, :boolean
timestamps()
end
def changeset(struct, params \\ %{}) do
struct
|> cast(params, [:title, :body])
|> validate_required([:title])
end
end
As you can see, we have included two different contexts, tags and categories
Now we can use a set of metaprogrammed functions:
Post.add_category(struct, tag)
- Passing a persisted struct will
allow you to associate a new tag
Post.remove_category(struct, tag)
- Will allow you to remove a tag
Post.categories_list(struct, tag)
- List all associated tags
Post.tagged_with_category(tag)
- Search for all tags associated to this context
Working with functions
If you want you can use directly a set of functions to play with tags: