Bulk Importer
Import files in Zip archives to your sections!
Description
Bulk Importer
The Bulk Importer allows you to upload a zip archive of files to Symphony. The extracted files are injected into a chosen section into an upload field. The name of the file is added to the first instance of a "text input" style field. Optionally, you can link the newly imported entries to another entry using either the Select Box Link, Reference Link, Bi Link or Subsection Manager extensions.
- Version: 0.9.3
- Date: June 8th 2011
- Requirements: Symphony 2.2 or newer, http://github.com/symphonycms/symphony-2/
- Author: Brendan Abbott brendan@bloodbone.ws
- GitHub Repository: https://github.com/brendo/bulk-importer
INSTALLATION
- Upload the 'bulkimporter' folder to your Symphony 'extensions' folder.
- Enable it by selecting the "Bulk Importer", choose Enable from the with-selected menu, then click Apply.
- You can now import files from the System -> Bulk Importer menu
Usage
- Choose a zip file of files that you wish to upload
- Select the section you want these files to be uploaded to and then select the upload field that these files should be uploaded to.
- Based on the section you have chosen, the Bulk Importer looks for all related sections and asks if you would like to link these entries using one of these section links. Select the section link and then the entry that you would like the imported files to be associated with.
Use Case
I have an Images section (Name - Textbox, Upload - Upload) and a Gallery section (Name - Textbox, Related Images - Subsection Manager). I choose the Images section and then the Upload field to import the files into. I then choose the Gallery: Related Images section link and the entry named 'My Test Album'. Clicking the 'import' button will upload the zip file, extract the files and then import them to the Images section. It will also associate these entries in the Images section with the 'My Test Album' entry in the Gallery section.
Supported Fields
Upload fields
Any extension that matches the /upload/i regular expression (which is all known at the time of writing).
Text Input fields
The Textbox field extension and the core Text Input field are supported.
Section Link fields
The Selectbox Link, Reference Link, Subsection Manager and BiLink extensions.
Bridges
Starting with 0.9.3, the Bulk Importer offers a bridge for the Subsection Manager that allows users to use the Bulk Importer interface (and features) from within an entry's context. This allows a user to attach multiple images quickly to an existing entry.
This bridge can be enabled on a per field basis, and is only available to existing entries.