a Media section, browsing the site's originals in place

a new section above Administration. it embeds THE PLATFORM'S OWN file browser rather
than drawing a file list — upload, delete, rename, move, thumbnails, the context
menu and every task hanging off it already exist and are maintained in one place. a
plugin's own would be a second to keep in step, arriving without any of that.

`basePath` IS A JAIL, not a starting folder: `useFileBrowserApp` resets currentPath
whenever it leaves, so pointing it at `<root>/media/originals` means the breadcrumb
stops there and `derived/` is not reachable by navigating. that is what was asked
for — people work in originals, derived is made for them.

IT IS A GUARDRAIL AND NOT A PERMISSION BOUNDARY, and the panel says so in its own
docstring because the difference will matter to whoever reads this next. the
file-browser API is unchanged and still addresses the whole home: anyone with file
access reaches derived/ through the Files screen. this prevents an accident, not a
determined person. confining it properly means scoping that API per user, which is a
platform change and a much larger one.

the panel also says, once, that derived/ exists and is made from these — otherwise
somebody who knows about it would think it had been lost.

`rootRelative` is new on the settings API because only the SERVER knows what home
is. the file browser addresses everything relative to a root, and a browser deriving
that prefix from the absolute path would be guessing. null when the root sits
outside home — a legitimate setting the browser cannot address, which the panel
explains rather than rendering an empty folder.

NOTHING HERE IS FOFOS-SPECIFIC, which matters now that this plugin is the template
for other site admins: the root is a setting, media/originals is the layout this
plugin creates, and both are read from the API. another site's plugin changes the
label.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

This commit is contained in:

pastilhas

2026-08-29 08:39:53 +01:00

co-authored by

Claude Opus 5

parent 9da0c31a90

commit 944d3d9c5b

5 changed files with 155 additions and 3 deletions

									
										web/DetailPanel.tsx
									
		+2
		
												View File
												
				@@ -1,6 +1,7 @@

				import { useSearchParams } from 'react-router';

				import { DEFAULT_SECTION, isSectionKey, sectionFor, type SectionKey } from './sections';

				import { AdministrationPanel } from './AdministrationPanel';

				import { MediaPanel } from './MediaPanel';

				import { MessagesPanel } from './MessagesPanel';

				import { PlannedSection } from './PlannedSection';

				import { useReady } from './useReady';

				@@ -39,6 +40,7 @@ import { useReady } from './useReady';

				const PANELS: Partial<Record<SectionKey, () => React.JSX.Element>> = {

				  messages: MessagesPanel,

				  administration: AdministrationPanel,

				  media: MediaPanel,

				};

				export const DetailPanel = () => {