pessek/hypeattachments

File attachments for Elgg

v3.1.2 2021-05-29 15:17 UTC

Requires

• php: >=7.1
• composer/installers: ~1.0
• hypejunction/acl_builder_api: ~1.0

proprietary

• Hermand PESSEK

• plugin
• files
• attachments
• elgg

README

Features

• API and UI for attaching files and other entities
• Form input for uploading file attachments
• Views for displaying attachments

Usage

Magic

If you add your entity subtype to a list of entities supporting attachments, the plugin will attempt to create all of the UI, necessary to upload and display attachments:

elgg_register_plugin_hook_handler('allow_attachments', 'object:my_subtype', '\Elgg\Values::getTrue');

Note that this generic approach might not work with all plugins, and may require additional customizations on your side.

Display an attachment input

echo elgg_view('input/attachments');

To add an attachments input to your comment and discussion replies forms, use the following code. You will not need to add any code to your save action.

echo elgg_view('input/attachments', [
	'name' => 'comment_attachments',
		]);

To add an attachments input to your personal messages and replies forms, use the following code. You will not need to add any code to your save action.

echo elgg_view('input/attachments', [
		'name' => 'message_attachments',
	]);

Note that if you are not using hypeDropzone, your form must have it's encoding set to multipart/form-data.

Attach uploaded files in an action

hypeapps_attach_uploaded_files($entity, 'upload', [
   'access_id' => $entity->access_id, // change the access level of uploaded files
]);

Attach an object

hypeapps_attach($entity, $attachment);

Display attachments

```php
echo elgg_view('output/attachments', [
	'entity' => $entity,
]);

Acknowledgements

• Early version of the plugin development has been partially sponsored by Social Business World