PHPackages getolympus/olympus-dionysos-field-upload - 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. [Framework](/categories/framework) 4. / 5. getolympus/olympus-dionysos-field-upload ActiveOlympus-field[Framework](/categories/framework) getolympus/olympus-dionysos-field-upload ======================================== Upload field, this component is a part of the Olympus Dionysos fields. v0.0.16(6y ago)02302MITJavaScript Since Apr 29Pushed 6y ago1 watchersCompare [ Source](https://github.com/GetOlympus/olympus-dionysos-field-upload)[ Packagist](https://packagist.org/packages/getolympus/olympus-dionysos-field-upload)[ Docs](https://github.com/GetOlympus/olympus-dionysos-field-upload)[ RSS](/packages/getolympus-olympus-dionysos-field-upload/feed)WikiDiscussions master Synced 2d ago READMEChangelogDependencies (1)Versions (18)Used By (2) Dionysos Upload Field ===================== [](#dionysos-upload-field) > This component is a part of the **Olympus Dionysos fields** for **WordPress**. > It uses the default `wpMedia` WordPress javascript bundle to manage field. ``` composer require getolympus/olympus-dionysos-field-upload ``` --- [![Olympus Component](https://camo.githubusercontent.com/f483886a465a9e44005a352c6c1ba6556689a579ecf0d8b984cf60becaaa878c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666f722d4f6c796d7075732d3434636331312e7376673f7374796c653d666c61742d737175617265)](https://github.com/GetOlympus)[![CodeFactor Grade](https://camo.githubusercontent.com/ae9738df37ae5ce85b5db016a40118eb0feb3e21fdce188f73f44d6eea8e7ca3/68747470733a2f2f7777772e636f6465666163746f722e696f2f7265706f7369746f72792f6769746875622f4765744f6c796d7075732f6f6c796d7075732d64696f6e79736f732d6669656c642d75706c6f61642f62616467653f7374796c653d666c61742d737175617265)](https://www.codefactor.io/repository/github/getolympus/olympus-dionysos-field-upload)[![Packagist Version](https://camo.githubusercontent.com/28b7398275b96ec4715549eedc392cb0b509d00fcc5d42d9424f5382f9477e99/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6765746f6c796d7075732f6f6c796d7075732d64696f6e79736f732d6669656c642d75706c6f61642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/getolympus/olympus-dionysos-field-upload)[![MIT](https://camo.githubusercontent.com/68035de4b7f69ada20e98e34172f47d361b83a017c8045200fc338660c467897/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49545f4c6963656e73652d626c75652e7376673f7374796c653d666c61742d737175617265)](https://github.com/GetOlympus/olympus-dionysos-field-upload/blob/master/LICENSE) --- [![](https://github.com/GetOlympus/olympus-dionysos-field-upload/raw/master/assets/field-upload-64.png)](https://github.com/GetOlympus/olympus-dionysos-field-upload/blob/master/assets/field-upload-64.png) --- Field initialization -------------------- [](#field-initialization) Use the following lines to add a `upload field` in your **WordPress** admin pages or custom post type meta fields: ``` return \GetOlympus\Dionysos\Field\Upload::build('my_upload_field_id', [ 'title' => 'What\'s your flavor?', 'can_upload' => false, 'default' => [], 'description' => 'Tell me what\'s your flavour!', 'multiple' => false, 'type' => 'image', 'size' => 'thumbnail', /** * Texts definition * @see the `Texts definition` section below */ 't_addblock_description' => 'Click on the "+" button to add a media.', 't_addblocks_description' => 'Click on the "+" button to add medias.', 't_cannot_upload' => 'It seems you are not able to upload files.', 't_name_label' => 'Edit the legend', 't_addblock_label' => 'Add', 't_editblock_label' => 'Edit', 't_removeblock_label' => 'Remove', ]); ``` Variables definition -------------------- [](#variables-definition) VariableTypeDefault value if not setAccepted values`title`String`'Upload'`*empty*`can_upload`Boolean`false``true` or `false``default`Array*empty**empty*`description`String*empty**empty*`multiple`Boolean`false``true` or `false``type`String`'image'`default file mime types`size`String`'thumbnail'`image sizes from `add_image_size()` [WordPress function](https://developer.wordpress.org/reference/functions/add_image_size/)Notes: - `can_upload` value is defined thanks to `current_user_can('upload_files')` (see [WordPress reference](https://codex.wordpress.org/Function_Reference/current_user_can)) - Set `multiple` to `true` to enable the "Add medias" button Texts definition ---------------- [](#texts-definition) CodeDefault valueDefinition`t_addblock_description`Click on the "+" button to add a media.Main helper to add a single item box`t_addblocks_description`Click on the "+" button to add medias.Main helper to add multiple items boxes`t_cannot_upload`It seems you are not able to upload files.Error displayed if user cannot upload files`t_name_label`Edit the legendName item's placeholder`t_addblock_label`AddUsed as an Add button area title`t_editblock_label`EditUsed as an Edit button area title`t_removeblock_label`RemoveUsed as a Remove button area titleRetrive data ------------ [](#retrive-data) Retrieve your value from Database with a simple `get_option('my_upload_field_id', [])` (see [WordPress reference](https://developer.wordpress.org/reference/functions/get_option/)). Below, a `json_encode()` example to understand how data are stored in Database: ``` { "mediaId": { "name": "mediaName.mediaExt", "id": "mediaId", "height": "mediaHeight", "url": "mediaUrl", "width": "mediaWidth" } } ``` And below, a simple example to show how to iterate on the data array in `PHP`: ``` // Get upload from Database $upload = get_option('my_upload_field_id', []); if (!empty($upload)) { foreach ($upload as $img) { echo ''; echo ''; echo ''.$img['name'].''; echo ''; } } ``` Release History --------------- [](#release-history) 0.0.16 - Remove useless admin scripts 0.0.15 - Display now compatible with new Zeus-Core version 0.0.14 - New Olympus components compatibility - Change repository to be a part of Dionysos fields Contributing ------------ [](#contributing) 1. Fork it () 2. Create your feature branch (`git checkout -b feature/fooBar`) 3. Commit your changes (`git commit -am 'Add some fooBar'`) 4. Push to the branch (`git push origin feature/fooBar`) 5. Create a new Pull Request --- **Built with ♥ by [Achraf Chouk](https://github.com/crewstyle "Achraf Chouk") ~ (c) since a long time.** ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity11 Limited adoption so far Community11 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 100% 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 ~94 days Recently: every ~62 days Total 16 Last Release 2243d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c255b14ebf8b792ba8b0c9940bd13e899281fc1431f1088af9074acdaa191cef?d=identicon)[crewstyle](/maintainers/crewstyle) --- Top Contributors [![crewstyle](https://avatars.githubusercontent.com/u/1572149?v=4)](https://github.com/crewstyle "crewstyle (22 commits)") --- Tags customfieldframeworkmedialibraryolympus-zeusphptwiguploadwordpressphpframeworkwordpressuploadfieldcustomolympusdionysosmedialib ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/getolympus-olympus-dionysos-field-upload/health.svg) ``` [![Health](https://phpackages.com/badges/getolympus-olympus-dionysos-field-upload/health.svg)](https://phpackages.com/packages/getolympus-olympus-dionysos-field-upload) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)