2017 © Pedro Peláez
 

library file-field

File Field library for ExpressionEngine 3

image

litzinger/file-field

File Field library for ExpressionEngine 3

  • Sunday, November 27, 2016
  • by litzinger
  • Repository
  • 1 Watchers
  • 0 Stars
  • 1,854 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 7 Versions
  • 8 % Grown

The README.md

composer require litzinger/file-field

This is a wrapper class to generate a fully functioning file field type within the ExpressionEngine 3 control panel (or front-end). It uses the native File_ft class to generate all the necessary HTML markup and JavaScript to render a fully functioning file field anywhere in the control panel. Its ideal for usage within 3rd party add-ons that need to save images as form options., (*1)

So why not use the native FilePicker service? Simple. It does not automatically create all of the necessary HTML and JavaScript needed to make a funtioning file field. You will need to register and maintain your own JavaScript callbacks. This class handles all of that for you because it uses the exact same code used to render the file picker in the control panel, which in turn uses the FilePicker service. By piggy backing off of the native File_ft it will render a working field in the control panel, or in a front-end channel:form tag., (*2)

Usage

$fieldName should be the name of the form field. Can be field_id_1, or foo[something][another_thing], (*3)

$fieldValue is the saved value in the database, usually {field_dir_1}something.png, (*4)

$settings is an array of settings required for the native EE File_ft class, (*5)

$fileField = new FileField($fieldName, $fieldValue, $settings);
$options .= '<div class="setting-txt"><em>Image</em></div>' . $fileField->render();

Roadmap

  • Add Symfony's OptionsResolver to validate the $settings array
  • Add compatibility with the Treasury field type?
  • Add compatibility with the Assets field type?

The Versions

27/11 2016

dev-master

9999999-dev

File Field library for ExpressionEngine 3

  Sources   Download

MIT

The Requires

 

by Brian Litzinger

27/11 2016

1.0.4

1.0.4.0

File Field library for ExpressionEngine 3

  Sources   Download

MIT

The Requires

 

by Brian Litzinger

20/09 2016

dev-develop

dev-develop

File Field library for ExpressionEngine 3

  Sources   Download

MIT

The Requires

 

by Brian Litzinger

20/09 2016

1.0.3

1.0.3.0

File Field library for ExpressionEngine 3

  Sources   Download

MIT

The Requires

 

by Brian Litzinger

18/09 2016

1.0.2

1.0.2.0

File Field library for ExpressionEngine 3

  Sources   Download

MIT

The Requires

 

by Brian Litzinger

18/09 2016

1.0.1

1.0.1.0

File Field library for ExpressionEngine 3

  Sources   Download

MIT

The Requires

 

by Brian Litzinger

17/09 2016

1.0.0

1.0.0.0

File Field library for ExpressionEngine 3

  Sources   Download

MIT

The Requires

  • php >=5.4

 

by Brian Litzinger