A demo is up at https://kaffy.gigalixirapp.com/admin
aesmail
aesmail
v0.4.0 (2020-05-13)
- [breaking] pass
connstruct to all callback functions. - [feature] introducing custom actions for single resources.
- [enhancement] fix typo in the resource form (thanks @axelclark).
Custom Actions
Kaffy supports performing custom actions on single resources by defining the resource_actions/1 function.
defmodule MyApp.Blog.ProductAdmin
def resource_actions(_conn) do
[
publish: %{name: "Publish this product", action: fn _c, p -> restock(p) end},
soldout: %{name: "Sold out!", action: fn _c, p -> soldout(p) end}
]
end
defp restock(product) do
update_product(product, %{"status" => "available"})
end
defp soldout(product) do
case product.id == 3 do
true ->
{:error, product, "This product should never be sold out!"}
false ->
update_product(product, %{"status" => "soldout"})
end
end
Result
resource_actions/1 takes a conn and must return a keyword list.
The keys must be atoms defining the unqiue action “keys”.
The values are maps providing a human-friendly :name and an :action that is an anonymous function with arity 2 that takes a conn and the record.
Actions must return one of the following:
{:ok, record}indicating the action was performed successfully.{:error, changeset}indicating there was a validation error.{:error, record, custom_error}to communicate a custom error message to the user where custom_error is a string.
2
jukvalim
Thanks for making this, I’ve been missing the power of Django admin in Phoenix, and Kaffy looks like it just might fill that gap!
3
aesmail
aesmail
v0.4.1 (2020-05-14)
- [feature] add custom field filters.
- [bugfix] sometimes if
index/1is not defined in the admin module, the index page is empty.
Custom filters
You can also provide some basic column-based filtration by providing the :filters option:
defmodule MyApp.Products.ProductAdmin do
def index(_) do
[
title: nil,
category_id: %{
value: fn p -> get_category!(p.category_id).name end,
filters: Enum.map(list_categories(), fn c -> {c.name, c.id} end)
},
price: %{value: fn p -> Decimal.to_string(p.price) end},
quantity: nil,
status: %{
name: "Is it available?",
value: fn p -> available?(p) end,
filters: [{"Available", "available"}, {"Sold out", "soldout"}]
},
views: nil
]
end
end
:filters must be a list of tuples where the first element is a human-frieldy string and the second element is the actual field value used to filter the records.
Result
3
areski
Amazing work 
Also a big fan of Django-admin here, we definitely need something like it for Phoenix!
1
aesmail
I’m very pleased to announce kaffy v0.5.0 with dashboard widgets.
This was the biggest missing thing on my todo list. I’m not 100% done with it. This is hopefully the tip of the iceberg.
Thanks to everyone who provided comments, suggestions, and/or PRs.
As always, your feedback is highly appreciated.
Check the dashboard page section.
9
aesmail
v0.6.0 (2020-05-18) (demo and github)
incompatible with v0.5.x
- [feature] support custom actions for a group of selected resources in index page.
- [enhancement] breaking change - always include the
:kaffy_browserpipeline to display templates correctly. Please check the minimum configurations section in the README for more information on how to upgrade. - [bugfix] resource index page table was displayed incorrectly when using a custom pipeline.
- [bugfix] all side menu resources are shown by default including sections that are not currently active.
- [bugfix] side menu does not scroll when there are too many contexts/schemas.
- [bugfix] side menu items all popup at the same time when viewed on small screens.
- [misc] added a demo link to the hex package page.
v0.5.1 (2020-05-17)
compatible with v0.5.0
- [enhancement] add a rich text editor option for form fields (
type: :richtext). - [bugfix] dashboard widgets were displayed improperly on small screens.
5
aesmail
Just released v0.7.0. The main feature in this release is scheduled tasks.
Check out the demo and the README section.
def scheduled_tasks(_) do
[
%{
name: "Cache Product Count",
initial_value: 0,
every: 300,
action: fn _v ->
count = Bakery.Products.count_products()
{:ok, count}
end
},
%{
name: "Delete Fake Products",
every: 60,
initial_value: nil,
action: fn _ ->
Bakery.Products.delete_fake_products()
{:ok, nil}
end
}
]
end
9