README

Image gallery in the administration of Drago Project, for images in the content of articles and pages.

Images are uploaded on one page and shown in a grid. Over an image appear three buttons: a full-size preview, copying it to paste into the content, and deleting it. A switch above the images sets what is copied: the Texy markup ([* /upload/gallery/photo.jpg *]) or only the path (/upload/gallery/photo.jpg); the browser remembers the choice.

Requirements

PHP >= 8.3, < 9
PHP extensions GD and intl
Drago Project

Installation

composer require drago-ex/project-gallery

Project Tools copies the files of the package into the project, where you adapt them. The gallery needs no database.

Assets

import GalleryCopy from './naja/gallery.js';

registerNajaExtensions(
	// ...
	GalleryCopy
);

and the styles of the buttons in assets/admin.scss:

@import 'naja/gallery';

The browser copies to the clipboard only over HTTPS and on localhost; elsewhere the text is offered in a dialog.

Administration

{link :Backend:Gallery:}

The menu item comes from Backend/Gallery/7.menu.neon with Backend UI.

Images are saved in www/upload/gallery/. An upload is resized to fit 1920 × 1920 px and gets a readable name made from the original one (Můj obrázek.JPG → muj-obrazek.jpg), numbered when the name is taken. Up to 20 images of at most 8 MB can be uploaded at once. Add /www/upload/ to .gitignore.

Permissions

The rules are in Backend/Gallery/acl.neon (resource Backend:Gallery, the administrator only). The privileges are default (the page with previews), upload and delete; the upload form and the delete buttons are shown only to those who may use them. Project Permission gives them to other roles, e.g. a role that only views and copies images with default.

The same file describes the privileges (permissionLabels) for the permissions page of Project Permission.

drago-ex / project-gallery

Package info

Security

Statistics