Skip to content

Digital-Peak/DPAttachments

Repository files navigation

DPAttachments

This is the official DPAttachments Github repository. DPAttachments is a slick Joomla attachment extension which provides drag and drop or copy paste file uploads for articles, DPCalendar events or DPCases cases, basically every component which triggers an onContentAfterDisplay event.

PREREQUISITS

  • Joomla 4.4
  • mysql >= 8.0.0
  • PHP >= 8.1.0

INSTALLATION

Download the file from here and install the zip file through the Joomla extension manager. After the installation make sure the plugins are enabled.

INTEGRATION

If you are an extension developer you just need the following code snippet to integrate DPAttachments into your extension:

echo $app->bootComponent('dpattachments')->render('com_demo.item', $object->id);

UPGRADE

To upgrade DPAttachments from an older version just install the downloaded zip file through the Joomla extension manager or by web update.

DOCUMENTATION

Check joomla.digital-peak.com for more documentation.

Development corner

If you are cloning this repository, then clone also the DPDocker project into the same folder as DPAttachments and build the images. There are several tasks you can run then:

Install PHP dependencies

Installs the PHP dependencies.

DPDocker/composer/run-install.sh DPAttachments

Install JS dependencies

Installs the Javascript dependencies.

DPDocker/npm/run-install.sh DPAttachments

Build assets

Builds the assets.

DPDocker/npm/run-build.sh DPAttachments all

Build packages

Creates the installable packages.

DPDocker/build/run.sh DPAttachments

Build a release

Creates the installable packages with version 4.0.0. Change the version string when you want to build a different release version.

DPDocker/build/run.sh DPAttachments 4.0.0

Fix code style

If you made some changes and want to contribute them back as a pr, please fix any code style issues.

DPDocker/code/run-fix.sh DPAttachments

Run system tests

Runs the system tests.

DPDocker/tests/run-system-tests.sh -j 4 -e DPAttachments

Start a web server

Start a web server with DPAttachments installed.

DPDocker/webserver/run.sh

Notes

License GPL v3

Have fun The Digital Peak team