Asset detail of the admin: metadata per locale, focal point, private flag, usage, replace, and presets

Open
#3,291 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
csharp
Domain
full-stack

Research direction

Read docs/planning/admin-technical-spec.md, sections 4.14, 5.2, and 10.4, and first confirm the A-21 dependency is available. The issue names FluentCMS.Plugins.Media.Admin, the media routes, component tests, contract tests against the OpenAPI document, and an end-to-end case. Done means the listed metadata, focal point, usage, asset actions, presets, and acceptance checks work; this is a broad feature with multiple dependencies.

Written by the indexing model from the issue text.

Description

area:admin type:feature

Problem

Rows 5.3, 5.7, 5.10 and 5.11 ask for an asset's metadata per locale, a focal point set in the admin, usage and replace, and private assets. The library of A-21 lists and uploads assets and cannot change one.

Proposal

In FluentCMS.Plugins.Media.Admin:

  • The detail panel of an asset: title, alt and caption in the content locale, credit, tags, and the private flag (GET and PATCH /media/{id} with If-Match). The alt and focal point parts are components of their own, which the field editor of A-20 reuses.
  • Focal point set by clicking the image, or with the arrow keys.
  • Usage as a list of entries with their labels, one list read per type (GET /media/{id}/usage, 2.7), each a link to its form.
  • Replace (POST /media/{id}/replace), download, which for a private asset goes through POST /media/{id}/download-url, move (POST /media/{id}/move), and delete with the usage shown first.
  • The page /media/presets for a caller with media.presets.manage: list, add, change and delete a preset (GET /media/presets, PUT and DELETE /media/presets/{name}).
  • The settings page of the media area stays the generated page of A6.

Acceptance

  • An editor sets the alt and the caption of an image in two locales, and each locale keeps its own
  • The focal point is set by a click and by the keyboard, and a preset's thumbnail follows it
  • Usage lists the articles that use an asset; delete shows them before it asks
  • A replaced asset shows its new thumbnail without a reload
  • A private asset downloads through a signed URL, and its original's URL answers no anonymous request
  • A save after another tab changed the asset shows the conflict, not a silent overwrite
  • An administrator adds and deletes a preset; an Editor does not see the presets page
  • Component tests cover the panel and the focal point; contract tests check the routes against the OpenAPI document (#3104); an end-to-end case edits metadata and replaces an asset

Design: docs/planning/admin-technical-spec.md, sections 4.14, 5.2 and 10.4 (A-50, split from A-21, AQ18). Rows 5.3, 5.7, 5.10, 5.11. Needs A-21; #3100, #3103 and #3104 are merged. Size: M.

Dominant language
C#
Stars
569
Forks
107
Avg merge
2h 49m
Merged PRs (30d)
397

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from fluentcms/FluentCMS

All issues in fluentcms/FluentCMS

Similar issues

More C# issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.