PHPackages                             convergine/craft-sharebox - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. convergine/craft-sharebox

ActiveCraft-plugin[File &amp; Storage](/categories/file-storage)

convergine/craft-sharebox
=========================

ShareBox allows to share files hosted on Azure Blob Storage or Amazon S3 with your site visitors.

1.0.1(2y ago)028proprietaryPHP

Since May 5Pushed 2y ago1 watchersCompare

[ Source](https://github.com/convergine/craft-sharebox)[ Packagist](https://packagist.org/packages/convergine/craft-sharebox)[ RSS](/packages/convergine-craft-sharebox/feed)WikiDiscussions master Synced yesterday

READMEChangelog (2)Dependencies (3)Versions (3)Used By (0)

ShareBox for Craft CMS 4 / Craft CMS 5
======================================

[](#sharebox-for-craft-cms-4--craft-cms-5)

[![Screenshot](./docs/images/ShareBox_Opening_Image.jpg)](./docs/images/ShareBox_Opening_Image.jpg)

ShareBox is a file manager plugin for CraftCMS v4.x that allows to upload and share files from Azure Blob Storage or Amazon S3 with your site visitors on the frontend.

For the plugin to work, an Amazon S3 (  ) or Azure Blob Storage (  ) account is required and an Azure Blob Storage API key must be created .

> **Note:** The plugin works only with the files and folders that will be created after connecting the plugin to your Azure/Amazon instance. It cannot display files or folders that already exist on your Azure/Amazon account. Only files / folders created through plugin will show up in directory view)

Features
--------

[](#features)

- AWS Integration: Easily upload files to Amazon S3 and share them in a "directory-view" on your website frontend
- Microsoft Azure Integration: Easily upload files to Azure Blob Storage and share them in a "directory-view" on your website frontend
- Password protect the files directory view on the front page (optional)
- Google ReCaptcha integration for the directory view
- Simple download statistics

Requirements
------------

[](#requirements)

- Azure Blob Storage or Amazon S3 account is rewquired for this plugin to work
- Craft CMS 4.0.0 or later
- PHP 8.0.2 or later

Installation
------------

[](#installation)

1. You can install this plugin from the Plugin Store or with Composer

```
# installation with composer

# 1. go to the project directory
cd /path/to/my-project

# 2. tell Composer to load the plugin
composer require convergine/craft-sharebox

# 3. tell Craft to install the plugin
./craft plugin/install craft-sharebox
```

2. Activate the plugin in the CraftCMS Control Panel (if it's not yet activated)
3. Edit your .env file and add the following variables:

```
# for Azure Blob Storage
SHAREBOX_PROVIDER=AZUREBLOB

# edit the following variables with your own values
AZURE_BLOB_STORAGE_KEY1=your_key
AZURE_BLOB_STORAGE_ACCOUNT_NAME=accountname
AZURE_CONTAINER=container

```

or

```
# for Amazon S3
SHAREBOX_PROVIDER=AMAZONS3

# edit the following variables with your own values
AWS_ACCESS_KEY_ID=your_key
AWS_SECRET_ACCESS_KEY=your_secret_key
AWS_REGION=ca-central-1
AWS_BUCKET=your_bucket

```

4. Configure the settings in plugin menu in the CraftCMS Control Panel

Go to ShareBox settings and enter the full URL of the page where you are going to display the file sharing `e.g. https://www.yourdomain.com/files-directory`

5. Adjust the twig template to display ShareBox:

```
# register the asset bundle (somewhere at the top of the file)
{% do view.registerAssetBundle("convergine\\sharebox\\assets\\FilesAssets") %}

# add the following code where you want the directory to show up
{% set files = craft.azurefiles.files%}
{{ files|raw }}

```

6. Now you are ready to proceed with uploading files through the plugin interface in the CraftCMS Control Panel.

> **Note:** If you decide to switch between Azure/Amazon after you've already created folders and uploaded files through the plugin interface, you will need to re-upload everything through plugin again, after the provider switch, as the plugin will see new provider's container as completely empty.

Customizing Design
------------------

[](#customizing-design)

At the moment, the only way to adjust the design of the frontend directory view is to either add the same styles that are used in Sharebox' frontend.css with `!important` attribute, or to add adjusted styles within your template where Sharebox' twig code is placed. Editing the styles directly in plugin files will result in overwritten changed upon update of the plugin.

Support
-------

[](#support)

For any issues or questions, you can reach us by email  or by opening an issue on GitHub.

Roadmap
-------

[](#roadmap)

- Support for local file storage
- Improved statistics

Screenshots
-----------

[](#screenshots)

[![Screenshot](./docs/images/ShareBox_Frontend_Login.jpg)](./docs/images/ShareBox_Frontend_Login.jpg)[![Screenshot](./docs/images/ShareBox_Frontend_Directory.jpg)](./docs/images/ShareBox_Frontend_Directory.jpg)[![Screenshot](./docs/images/ShareBox_Backend_Directory.jpg)](./docs/images/ShareBox_Backend_Directory.jpg)[![Screenshot](./docs/images/ShareBox_Backend_Statistics.jpg)](./docs/images/ShareBox_Backend_Statistics.jpg)[![Screenshot](./docs/images/ShareBox_Backend_Settings.jpg)](./docs/images/ShareBox_Backend_Settings.jpg)

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~321 days

Total

2

Last Release

833d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7737586?v=4)[Convergine](/maintainers/convergine)[@convergine](https://github.com/convergine)

---

Top Contributors

[![convergine](https://avatars.githubusercontent.com/u/7737586?v=4)](https://github.com/convergine "convergine (2 commits)")[![konstantin-convergine](https://avatars.githubusercontent.com/u/158498311?v=4)](https://github.com/konstantin-convergine "konstantin-convergine (1 commits)")

---

Tags

aws-s3azure-file-storagecraft-plugincraftcmscraftcms-pluginfilesharefilesharingcmsCraftcraftcmscraft-plugincloud-storageamazon-s3file hostingazure blob storagefile libraryconverginecraft file managerpublic file sharingfiles sharing

### Embed Badge

![Health badge](/badges/convergine-craft-sharebox/health.svg)

```
[![Health](https://phpackages.com/badges/convergine-craft-sharebox/health.svg)](https://phpackages.com/packages/convergine-craft-sharebox)
```

###  Alternatives

[verbb/formie

The most user-friendly forms plugin for Craft.

102393.6k69](/packages/verbb-formie)[spacecatninja/imager-x

Ninja powered image transforms.

29405.1k38](/packages/spacecatninja-imager-x)[verbb/vizy

A flexible visual editor field for Craft.

4250.4k](/packages/verbb-vizy)[verbb/hyper

A user-friendly links field for Craft.

24147.8k12](/packages/verbb-hyper)[verbb/events

A full-featured plugin for event management and ticketing.

2311.9k](/packages/verbb-events)[servd/craft-remote-assets

Move CP assets to an external filesystem such as S3

1215.8k](/packages/servd-craft-remote-assets)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
