phpBB Multi File Upload Mod

* **Abstract** * **The purpose of this project is to improve phpBB file upload capabilities by simply enabling a user to select multiple files from the standard OS browse files window and upload them.** * **Coding guidelines to be consistent with community established phpBB coding standards as described here: <[login to view URL]>** ## Deliverables * **Abstract** * **The purpose of this project is to improve phpBB file upload capabilities by simply enabling a user to select multiple files from the standard OS browse files window and upload them.** * **Coding guidelines to be consistent with community established phpBB coding standards as described here: <[login to view URL]>** * **Environment** * **Standard LAMP technology stack** * **Base install of phpBB 3.0.10** * **Use one of the following multi-select open source plugin projects** * **<[login to view URL]>** * **<[login to view URL]>** * **Deliverables** * **Standard MODx guidelines for functional extensibility to the phpBB project.** * **All SQL statements that are used, if needed, to alter the generic base database.** * **Summary of all file changes needed** * **Summary of installation instructions** * **Summary of helper files needed and where to put them** * **These can be *.php files provided they follow the coding guidelines referenced elsewhere in this document** * **These can be *.html files provided they follow the coding guidelines referenced elsewhere in this document** * **These can be *.css files provided they follow the coding guidelines referenced elsewhere in this document** * **Config files are not allowed. If needed, a separate ACP (Administrative Control Plugin) must be developed in order to provide any required configurations. Do not place any configuration variables in any of the aforementioned files.** * **Licensing** * **This MOD can be contributed to the phpBB community with the developer named. In fact, we encourage it.** * **Standard phpBB licensing** * **Must start a phpBB MOD developement topic for this project so that others can use it.** * **We are happy to donate server space for MOD downloads and demos.** * **We will arrange this after we have completed this project.** * **Characteristics** * **phpBB Pages** * **Private Messaging** * **New composition** * **Replying** * **Editing** * **Drafts** * **Post Messaging** * **New composition** * **Replying** * **Editing** * **Drafts** * **Actions:** * **Save Draft Button** * **If any files have already been uploaded via the module or native file uploads, first delete those files before performing usual phpBB processing and save the posting as a draft without any attachments** * **If any files have not been already uploaded or if any files have been selected but not yet uploaded, discard those files ignoring them and just save the draft as phpBB would normally save them.** * **Preview Button** * **If any files have been selected in the new module prior to the preview button being pressed, assume 'start upload' action first, then continue with usual phpBB handling of pressed preview button.** * **If no files were previously selected in the new module, continue with the normal phpBB processing of the phpBB preview button being pressed.** * **Submit Button** * **If any files have been selected in the new module prior to the submit button being pressed, assume 'start upload' action first, then continue with usual phpBB handling of pressed submit button.** * **If no files were previously selected in the new module, continue with the normal phpBB processing of the phpBB submit button being pressed.** * **Start Upload Button || Add File Button** * **If any file(s) have been selected in the new module, the user can only see one start upload button or one add file button, but they can never see both. This is because of fall back handling described elsewhere in this document.** * **The actions performed after a user presses the 'Start Upload Button' or 'Add File Button' are the same. Those actions are to perform the upload of the file(s), and process those files as phpBB would natively handle them assuming the message is not 'Saved as a Draft', nor ' Previewed', nor 'Submitted'. An example illustration of this is provided.** * **After the files have finished uploading, phpBB lists each of the upload files in a section labeled 'ADDED ATTACHMENTS' with a 'File comment' field for each file. This is the native functionality of phpBB and no changes are being requested at this stage of the process.** * **Browser Plugin Fall Back Handling** * **If the module cannot successfully load, use native phpBB upload module** * **Do NOT browser sniff for testing. Us object testing instead** * **Unacceptable: if ('navigator' == [login to view URL])** * **Acceptable: if ('success' == [login to view URL])** * **ACP Considerations and Guidelines** * **Only required if configurations are needed.** * **Do not hardcode any configurations...use a separate ACP** * **Feel free to use existing ACP configurations to** * **Illustrations available**