Simple:Press Documentation

Plugin: File Uploader

Plugin Description

Plugin: File Uploader – This Simple:Press plugin provides the ability to upload images, media and files in forum posts. This plugin is also know as “Image, Media, and File Uploader” and the “File Uploader with Plupload”.

Plugin Features

Installing this Simple:Press plugin adds:

  • A new File Uploader with Plupload section in the “Available Plugins – Install Simple:Press Plugins” panel under the forum Admin menu path Forum > Plugins > Available Plugins. From this panel the plugin can be activated, or deleted by the admin.
  • When properly installed, a new folder in the “forum-plugin” folder named “plupload” containing the plugin’s files.

Activating this plugin provides:

  • A change to the new File Uploader with Plupload section in the “Available Plugins – Install Simple:Press Plugins” panel under the Admin menu path Forum > Plugins > Available Plugins so the Simple:Press plugin can be deactivated, uninstalled, or have its Options set up.
    • The Options link goes to the new “File Uploader – Settings” forum Admin panel.
    • The “Getting Started” link associated with the “Deactivate/Uninstall/Options” selections should be selected to view the pertinent information regarding the plugin.
  • A new sub-menu item “File Uploads” under the “Components” forum Admin menu linked to the new “”File Uploader – Settings” forum Admin panel.
    • The “File Uploads” sub-menu item is accessed at Forum > Components.
  • A new “File Uploader – Settings” forum Admin panel where the options for file uploads are set by the forum Admin.
    • The “Help” link should be used for assistance in setting up the options.
    • The allowed and disallowed file types for uploading can be specified.
    • The maximum file size and dimensions of uploaded files can be specified.
    • The “File Uploader – Settings” forum Admin panel can be accessed under the Admin menu path Forum > Components > File Uploads.
  • A new folder “forum-image-uploads” for storage of “image files” and “signature files” uploaded by users with the correct permissions using the plugin. The folder is located as a default in the sp-resources folder at … /wp-content/sp-resources.
    • Each forum user who has uploaded these categories of files gets a folder with their Display Name on it containing their uploaded files of this category under the main folder.
    • Sub-folders under the users Display Name are named for the year (e.g. 2016) files were uploaded, and sub-folders in the year folder are named for the month (e.g. 01 = January) files were uploaded. Uploaded files are contain in the month sub-folders.
  • A new folder “forum-media-uploads” for storage of allowed “media files” uploaded by users with the correct permission using the plugin located as a default in the sp-resources folder at … /wp-content/sp-resources.
    • Each forum user who has uploaded this category of files gets a folder with their Display Name on it containing their uploaded files of this category under the main folder.
    • Sub-folders under the users Display Name are named for the year (e.g. 2016) files were uploaded, and sub-folders in the year folder are named for the month (e.g. 01 = January) files were uploaded. Uploaded files are contain in the month sub-folders.
  • A new folder “forum-file-uploads” for storage of “other files” uploaded by users with the correct permission using the plugin located as a default in the sp-resources folder at … /wp-content/sp-resources.
    • Each forum user who has uploaded this category of files gets a folder with their Display Name on it containing their uploaded files of this category under the main folder.
    • Sub-folders under the users Display Name are named for the year (e.g. 2016) files were uploaded, and sub-folders in the year folder are named for the month (e.g. 01 = January) files were uploaded. Uploaded files are contain in the month sub-folders.
  • Three (3) new entries on the “Integration – Storage Locations” forum Admin panel identifying the location of the three (3) new upload storage folders.
    • A new “Image uploads folder” entry showing the location of the new “forum-image-uploads” folder.
    • A new “Media uploads folder” entry showing the location of the new “forum-media-uploads” folder.
    • A new “File uploads folder” entry showing the location of the new “forum-file-uploads” folder.
    • The “Integration – Storage Locations” forum Admin panel can be accessed under the Admin menu path Forum > Integration > Storage Locations.

For the users with the “Can upload signature images” permission:

  • A new “Upload Image ” button at the bottom of their “Edit Signature” profile page allowing them to use this plugin to upload a “signature image” file and use it on their posts.
    • This button is linked to the new “File Select” Popup Window (Upload Pane) where files to be uploaded are placed before being uploaded.
    • “Signature image” files are stored in the “forum-image-uploads” main folder in a sub-folder having the user’s Display Name.
    • The “Edit Signature” page is accessed by clicking on the “Profile” button in the forum header to go the the logged in user’s profile, clicking the “Profile” tab, then clicking the “Edit Signature” sub-tab.

For the users with the necessary Upload (Image, Media, Files) permissions:

  • A new “Upload Attachments” button displayed below text input area in the “Add Topic” form displayed when the “Add Topic” button is clicked within a forum.
    • This button is linked to the new “File Select” Popup Window (Upload Pane) where files to be uploaded are placed before being uploaded.
  • A new “Upload Attachments” button displayed below text input area in the “Add Reply” form displayed when the “Add Reply” button is clicked within a forum.
    • This button is linked to the new “File Select” Popup Window (Upload Pane) where files to be uploaded are placed before being uploaded.

The “Select Files” popup Window (Upload Pane):

  • A new “Select Files” popup Window (Upload Pane) where files (image, media, or other) the user is allowed to upload are placed before being uploaded.
    • The window is displayed when
      • the “Upload Attachments” button is clicked in the”Add Topic” form.
      • the “Upload Attachments” button is clicked in the”Add Reply” form.
      • the “Upload Image” button is clicked in the “Edit Signature” form in the logged in users profile.
    • The forum users can select to view the files placed in the window as thumbnails or in a list by their filenames.
    • Permissions determine which types of files can be placed in the window for uploading.
      • If the users have the “Can upload images in posts” permission, they can place image file types specified by the forum Admin in the window for uploading.
      • If the users have the “Can upload media in posts” permission, they can place media file types specified by the forum Admin in the window for uploading.
      • If the users have the “Can upload files in posts” permission, they can place other file types specified by the forum Admin in the window for uploading.
      • If the users have the “Can upload signature images” permission, they can place signature image files in the window for uploading.

For users with the “Can manage their uploaded attachments in profile” permission

    • A new “Attachments” tab in the logged in user’s profile with sub-tabs “Image Uploads“, “Media Uploads” and “File Uploads” through which the logged in user can reach the new “Image Uploads” panel, the new “Media Uploads” panel and the new “File Uploads” panel to manage image files, media files, and other uploaded files, respectively.
      • The “Attachments” tab is accessed by clicking on the “Profile” button in the forum header.
    • A new “Image Uploads” panel in the logged in user’s profile where the logged in user can view their uploaded image files and delete them, if desired.
      • The “Image Uploads” panel is accessed by clicking on the “Profile” button in the forum header to go the the logged in user’s profile, clicking the “Attachments” tab, then clicking the “Image Uploads” sub-tab.
    • A new “Media Uploads” panel in the logged in user’s profile where the logged in user can view their uploaded media files and delete them, if desired.
      • The “Media Uploads” panel is accessed by clicking on the “Profile” button in the forum header to go the the logged in user’s profile, clicking the “Attachments” tab, then clicking the “Media Uploads” sub-tab.
    • A new “File Uploads” panel in the logged in user’s profile where the logged in user can view their uploaded “other” files and delete them, if desired.
      • The “File Uploads” panel is accessed by clicking on the “Profile” button in the forum header to go the the logged in user’s profile, clicking the “Attachments” tab, then clicking the “File Uploads” sub-tab.

Five (5) new

    permissions are added to the permission “Uploading” category due to this plugin.

    • “Can upload images in posts”.
    • “Can upload media in posts”.
    • “Can upload files in posts”.
    • “Can upload signature images”.
    • “Can manage their uploaded attachments in profile”.
    • A permission set is edited from the forum Admin menu at Forum > Permissions > Manage Permission Sets by clicking on the “Edit Permission” button associated with the permission set.

Plugin Requirements

Simple:Press version 5.6.2 and above is required.

This plugin must be installed, activated, and its options set before it is operational.

As part of the installation, a “File Uploader with Plupload” section is added to the Plugin Management panel under the admin menu Forum > Plugins > Available Plugins. From this panel the plugin can be activated, deactivated, uninstalled, deleted, or its options set using its “Activate/Delete” and “Deactivate/Uninstall/Options” selections.

  • The Options link goes to the new “File Uploader – Settings” forum Admin panel where this plugin’s options are set by the forum Admin.

There are five (5) new permissions added to the permission sets due to this plugin that must be enabled in the permission sets for the usergroups being allowed to upload various file types and manage their uploaded files.

The plugin has no (0) template tags so there are no recommendations made regarding developing Child Themes or Custom Themes to accommodate changes to template tags.

Plugin Installation and Activation

Please see Using Plugins how to obtain and install this Simple:Press plugin.

  • Whatever method is used to add the Simple:Press plugin, the folder that should have been added to the forum plugin folder is named “plupload“.
  • If using the “Simple:Press Upload Plugin – Upload a Simple:Press Plugin” panel at the forum Admin menu Forum > Plugins > Plugin Uploader, the folder to browse for after downloading it from the Simple:Press site is “plupload.zip” before clicking the “Upload Now” button.

As mentioned there the default location for Simple:Press plugin folders is …/wp-content/sp-resources/forum-plugins. If this path is changed, it is important to note that the plugin’s folder and its content need to reside in the forum plugins folder wherever it has been moved and however it has been renamed. See Storage Locations for more information.

Activation is accomplished from the Admin Dashboard panel menu by selecting Forum > Plugins > Available Plugins from the drop down forum Admin menu. On the “Available Plugins – Install Simple:Press Plugins” panel select the “File Uploader with Plupload” plugin and click on “Activate”. The “Activate/Delete” label changes to “Deactivate/Uninstall/Options” with a “Get Started” Link.

  • The “Getting Started” link associated with the “Deactivate/Uninstall/Options” selections should be selected to view the pertinent information regarding the plugin.

To deactivate the plugin, click on “Deactivate”. The “Deactivate/Uninstall/Options” label changes to “Activate/Delete”.
To re-activated the plugin, click on on “Activate”. The “Activate/Delete” label changes to “Deactivate/Uninstall/Options”.

 

Plugin Administrative Options

After activation, a) on the aforementioned “Available Plugins – Install Simple:Press Plugins” panel, click “Options” on the File Uploader with Plupload plugin section or b) under the Components entry on the forum menu on the left side forum admin page click the File Uploads sub-menu item to get the “File Uploader – Settings” Admin panel.

Note:
Maximum upload limits are not applied to forum Administrators.
    • Specifying Image File Options
      • Go to the “Image Files” section of the Admin panel.
        • Please click on the section’s “Help” link for more information.
      • Choose whether uploaded images to appear in the post itself or just as an attachment. If the image is to appear in the post, it will be inserted and display size will be controlled by the thumbnail options (either full size or thumbnail).
        • To automatically insert images into the post content, click in the check box to the left of “Auto insert images into post content”.
WARNING: If this option is NOT selected and the “Show attachments uploaded to post content in the attachments section below post content” option in the Settings section is also NOT selected, when an image upload is done in a post there will be NO indication when viewing the post that an image upload had been done there.
        • The check box is selected if it contains a green check mark.
        • Clicking in a check box with a green check mark will disable the option and remove the check mark.
    • The image quality of re-sized images and image thumbnails can be set. To keep the maximum quality, set the quality to 100. The lower the quality, the smaller the image file size will be and the quicker the image will load on the site. The image re-size quality only applies if a maximum width or height to the image has been set and the uploaded image is larger.
      • To set the image quality of a resized image, enter the image quality (0 – 100)in the text input box to the right of “Image quality of resized images (0-100):”. The default is 100.
      • To set the image quality of generated thumbnails, enter the image quality (0 – 100)in the text input box to the right of “Image quality of generated thumbnails (0-100):”. The default is 100.
    • The maximum file size of the image (in bytes) can be set. Attempts to upload a file larger than the limit will result in a upload error.
      • To set the maximum size in bytes of image files, enter the maximum size in the text input box to the right of “Maximum size (in bytes) of image files (0 = no limit) …:”. The default is 51200.
        • Entering a “0” results in no limit other than the PHP limits shown.
        • PHP UPLOAD_MAX_SIZE is 2097152
        • PHP POST_MAX_SIZE is 8388608
    • The maximum width or height of the image that gets uploaded can be set. If these are set to 0, there will be no limit. Use caution in allowing large uploads as it will take large amounts of CPU to process the images and more disk space will be used. Any images larger in width or height than the maximums, will be re-sized keeping the current aspect ratio.
      • To set the maximum width in pixels of image files, enter the maximum width in the text input box to the right of “Maximum width (in pixels) of image files (0 = no limit):”. The default is 0 for no limit.
      • To set the maximum height in pixels of image files, enter the maximum height in the text input box to the right of “Maximum height (in pixels) of image files (0 = no limit):”. The default is 0 for no limit.
    • To set the allowed image files types, enter the image files types separated by a comma in the text input box to the right of “Allowed File Types:”. Any image type not on the list will be disallowed. The default is jpg,jpeg,gif,png.
    • If there are no more options to set on the page, click on the “Update” button at the bottom of the panel to save the settings. Otherwise proceed to the next section.
    • Specifying Media File Options
      • Go to the “Media Files” section of the Admin panel.
        • Please click on the section’s “Help” link for more information.
      • Choose whether uploaded images to appear in the post itself or just as an attachment.
        • To automatically insert media into the post content, click in the check box to the left of “Auto insert media into post content”.
WARNING: If this option is NOT selected and the “Show attachments uploaded to post content in the attachments section below post content” option in the Settings section is also NOT selected, when a media upload is done in a post there will be NO indication when viewing the post that a media upload had been done there.
        • The check box is selected if it contains a green check mark.
        • Clicking in a check box with a green check mark will disable the option and remove the check mark.
    • The maximum file size of the media allowed (in bytes) can be set for media uploads. Attempts to upload a file larger than the limit will result in a upload error.
      • To set the maximum size in bytes of media files, enter the maximum size in the text input box to the right of “Maximum size (in bytes) of media files (0 = no limit) …:”. The default is 0.
        • Entering a “0” results in no limit other than the PHP limits shown.
        • PHP UPLOAD_MAX_SIZE is 2097152
        • PHP POST_MAX_SIZE is 8388608
    • To set the allowed media files types, enter the media files types separated by a comma in the text input box to the right of “Allowed file types:”. Any media type not on this list will be disallowed. The file types list is case sensitive. The default is swf, dcr, mov, qt, mpg, mp3, mp4, mpeg, avi, wmv, wm, asf, asx, wmx, wvx, rm, ra, ram.
    • To set the maximum width in pixels of media files, enter the maximum width in the text input box to the right of “Maximum width (in pixels) of media files:”. The default is 320.
    • To set the maximum height in pixels of media files, enter the maximum height in the text input box to the right of “Maximum height (in pixels) of media files:”. The default is 240.
    • If there are no more options to set on the page, click on the “Update” button at the bottom of the panel to save the settings. Otherwise proceed to the next section.
    • Specifying Other File Types Options
      • Go to the “Other File Types” section of the Admin panel.
        • Please click on the section’s “Help” link for more information.
      • To automatically insert other file attachments into post content as a link, click in the check box to the left of “Auto insert file attachments into post content as a link”.
WARNING: If this option is NOT selected and the “Show attachments uploaded to post content in the attachments section below post content” option in the Settings section is also NOT selected, when a file upload is done in a post there will be NO indication when viewing the post that a file upload had been done there.
      • The check box is selected if it contains a green check mark.
      • Clicking in a check box with a green check mark will disable the option and remove the check mark.
    • To set the maximum size in bytes of other files, enter the maximum size in the text input box to the right of “Maximum size (in bytes) of media files (0 = no limit) …:”. The default is 51200.
      • Entering a “0” results in no limit other than the PHP limits shown.
      • PHP UPLOAD_MAX_SIZE is 2097152
      • PHP POST_MAX_SIZE is 8388608
    • To set the allowed other files types, enter the other files types separated by a comma in the text input box to the right of “Allowed other file types:”. Any other file types not on this list will be disallowed. The default is txt,rtf,doc,pdf.
    • If there are no more options to set on the page, click on the “Update” button at the bottom of the panel to save the settings. Otherwise proceed to the next section.
    • Specifying Settings Options
      • Go to the “Settings” section of the Admin panel.
        • Please click on the section’s “Help” link for more information.
      • To replace the Simple:Press profile photo URLs with uploaded photos, click in the check box to the left of “Replace the SP profile photo urls with uploaded photos”.
        • The check box is selected if it contains a green check mark.
        • Clicking in a check box with a green check mark will disable the option and remove the check mark.
      • To set the language (English, French, Russian, etc.) displayed in the uploader, enter the two (2) character language code (ie. en, fr, ru, etc.) in the text input box to the right of “Plupload language code:”. The default is English (en).
        • To see if a language exists, please see the files identified within ‘… forum-plugins/plupload/resources/jscript/i18n’ folder for the website.
        • The language selected is used on the popup window where files to be uploaded are to be “dropped” that appears after the “Upload Attachments” button is selected.
Note:
Be sure to also install the plugin’s language files using one of the methods in this Codex page’s Plugin Language Translation section. These language files allow translation of phrases associated with the plugin that are used throughout the forum including the Admin panels.
      • To show attachments uploaded into a post’s content also in the attachments section below the post content, click in the check box to the left of “Show attachments uploaded to post content in the attachments section below post content”.

WARNING: If this option is NOT selected and the below options are also NOT selected for the various file categories, when a file upload of that category file is done in a post there will be NO indication when viewing the post that a file upload of that category (image, media, other file type) was done there.

  • the “Auto insert images into post content” option in the Image section of this Admin panel.
  • the “Auto insert media into post content” in the Media section of this Admin panel.
  • the “Auto insert file attachments into post content as a link” in the Other File Types section of this Admin panel.
      • The check box is selected if it contains a green check mark.
      • Clicking in a check box with a green check mark will disable the option and remove the check mark.
    • To show an uploaded files list as a series of thumbnails, click in the check box to the left of “Show uploaded files list as thumbnails”.
      • The check box is selected if it contains a green check mark.
      • Clicking in a check box with a green check mark will disable the option and remove the check mark.
    • If there are no more options to set on the page, click on the “Update” button at the bottom of the panel to save the settings. Otherwise proceed to the next section.
  • Specifying Prohibited Files Options
    • Go to the “Prohibited Files” section of the Admin panel.
      • Please click on the section’s “Help” link for more information.
    • To set the prohibited file types, enter the prohibited files types separated by a comma in the text input box to the right of “Prohibited file types:”. The default is php, php3, php5, js, html, htm, phtml, asp, aspx, ascx, jsp, cfm, cfc, pl, bat, exe, dll, reg, cgi, sh, py.
    • If there are no more options to set on the page, click on the “Update” button at the bottom of the panel to save the settings. Otherwise proceed to the next section.

From the Forum Admin menu on the left of admin pages, select Forum > Permissions > Manage Permission Sets to see the permission sets available.

  • Assigning New Permissions
    • “Can upload images in posts” permission
      • Allowing users to upload images in forum posts is controlled by their group permissions.
      • Each usergroup that is to have this ability must have the permission turned on.
      • This is accomplished from the Simple:Press Administration panel Admin menu by clicking/opening Forum > Permissions > Manage Permission Sets.
      • Select “Edit Permission” for the permission set to be updated to view the “Permissions – Manage Permissions” panel.
      • Under “Uploading” click the check box next to “Can upload images in posts” to set/enable the permission. When enabled, the check box contains a green check mark.
      • If there are no other permissions to set, click the “Update Permission” button at the bottom of the page to have the selection saved.
      • At a later time clicking the check box when it has a green check mark removes the check mark and will remove the permission when followed by clicking “Update Permission” to save the revised selection.
      • Repeat these steps on each usergroup to have this permission.
    • “Can upload media in posts” permission
      • Allowing users to upload media in forum posts is controlled by their group permissions.
      • Each usergroup that is to have this ability must have the permission turned on.
      • This is accomplished from the Simple:Press Administration panel Admin menu by clicking/opening Forum > Permissions > Manage Permission Sets.
      • Select “Edit Permission” for the permission set to be updated to view the “Permissions – Manage Permissions” panel.
      • Under “Uploading” click the check box next to “Can upload media in posts” to set/enable the permission. When enabled, the check box contains a green check mark.
      • If there are no other permissions to set, click the “Update Permission” button at the bottom of the page to have the selection saved.
      • At a later time clicking the check box when it has a green check mark removes the check mark and will remove the permission when followed by clicking “Update Permission” to save the revised selection.
      • Repeat these steps on each usergroup to have this permission.
    • “Can upload files in posts” permission
      • Allowing users to upload ‘other’ file types (.doc, .pdf, etc.) in forum posts is controlled by their group permissions.
      • Each usergroup that is to have this ability must have the permission turned on.
      • This is accomplished from the Simple:Press Administration panel Admin menu by clicking/opening Forum > Permissions > Manage Permission Sets.
      • Select “Edit Permission” for the permission set to be updated to view the “Permissions – Manage Permissions” panel.
      • Under “Uploading” click the check box next to “Can upload files in posts” to set/enable the permission. When enabled, the check box contains a green check mark.
      • If there are no other permissions to set, click the “Update Permission” button at the bottom of the page to have the selection saved.
      • At a later time clicking the check box when it has a green check mark removes the check mark and will remove the permission when followed by clicking “Update Permission” to save the revised selection.
      • Repeat these steps on each usergroup to have this permission.
    • “Can upload signature images” permission
      • Allowing users to upload signature images is controlled by their group permissions.
      • Each usergroup that is to have this ability must have the permission turned on.
      • This is accomplished from the Simple:Press Administration panel Admin menu by clicking/opening Forum > Permissions > Manage Permission Sets.
      • Select “Edit Permission” for the permission set to be updated to view the “Permissions – Manage Permissions” panel.
      • Under “Uploading” click the check box next to “Can upload signature images” to set/enable the permission. When enabled, the check box contains a green check mark.
      • If there are no other permissions to set, click the “Update Permission” button at the bottom of the page to have the selection saved.
      • At a later time clicking the check box when it has a green check mark removes the check mark and will remove the permission when followed by clicking “Update Permission” to save the revised selection.
      • Repeat these steps on each usergroup to have this permission.
    • “Can manage their uploaded attachments in profile” permission
      • Allowing users to manage their uploaded attachments in their profile is controlled by their group permissions.
      • Each usergroup that is to have this ability must have the permission turned on.
      • This is accomplished from the Simple:Press Administration panel Admin menu by clicking/opening Forum > Permissions > Manage Permission Sets.
      • Select “Edit Permission” for the permission set to be updated to view the “Permissions – Manage Permissions” panel.
      • Under “Uploading” click the check box next to “Can manage their uploaded attachments in profile” to set/enable the permission. When enabled, the check box contains a green check mark.
        • A new “Attachments” tab will show up in the allowed user’s profile where their attached files can be managed/deleted.
      • If there are no other permissions to set, click the “Update Permission” button at the bottom of the page to have the selection saved.
      • At a later time clicking the check box when it has a green check mark removes the check mark and will remove the permission when followed by clicking “Update Permission” to save the revised selection.
      • Repeat these steps on each usergroup to have this permission.

To be complete for multilingual forums, the language translation files for this plugin should be installed or downloaded/properly placed in the appropriate forum-language folder for SP plugins using one of the procedures below in the “Plugin Language Translation” section of this page.

 

Plugin Language Translation

A plugin may not have language translation files, but in general each Simple:Press plugin has its own language translation files each with multiple pages for translating the forum plugin’s message strings.

Forum Plugin translation files are to reside in a unique forum folder location as defined by the “Simple:Press Plugin Language Files” entry on the “Integration – Storage Locations” forum Admin panel available through the forum Admin menu at Forum > Integration > Storage Locations.

  • The default location for forum plugin translation files is the folder “…/wp-content/sp-resources/forum-language/sp-plugins”.

Information regarding downloading language files, “mo’ language file placement, and translation (language localization) is found at Localization.

WARNING: On the Localization page, the Language Translation “.mo” Files Overview should be reviewed and well understood for naming convention and language translation file placement.

More information is available regarding translation files at Simple:Press Translations. which is the repository for Simple:Press language translation files. On the base page, select the “Getting Started Guide” link for basics about it’s use. On that page, select the “register a username here” link to obtain a password to the site. Use the “Contact Form” link to request the desired language if it is not currently available. The “Contact Form” link may also be used to volunteer to be a validator for a translation project.

This plugin’s available language translation files with translation statistics, and message translations can be viewed at File Uploader within the repository for Simple:Press language translation files.

  • Installing this Simple:Press Plugin’s Language Translation “.mo” files
    The plugin’s language translations files for each language can be correctly located in two ways.

    • Using the Admin Word:Press “Site Language” and Simple:Press “Language Translation” Features
      WARNING: On the Localization codex page, the Language Translation “.mo” Files Overview should be reviewed and well understood for naming convention and language translation file placement.
        • Under the “Language Translation Selection Sequences” heading, the “Coordinated Language Translation File Download Using the Simple:Press ‘Language Translation’ Selection” section, follow the instructions at “Adding its Translation File(s) After Downloading/Activating a Simple:Press Theme or Simple:Press Plugin”.
          • Follow the instructions to select the “Site Language” and then get to the admin page with the “Integration – Language Translations” section where there should be an entry for “File Uploader with Plupload” along with an “Install” button.
          • Click on the “Install” button for this plugin to install the language translation file for the current “Site Language” language.
            • Note: If the message “No Translation Project Exists” is displayed rather than the “Install” button, a translation file for that language could not be found in GlotPress at this time. Consider posting in the Simple:Press forum if it is felt there needs to be one added.
          • Be sure to verify the locale (filename) for the “.mo” file matches the language code for the language as referenced in the “Warning” above. If it does not, change it to match.
          • As called out in the section, continue to change the “Site Language” language and repeat the process until all desired translation files for this plugin have been installed.

       

    • Manually Finding and Storing Simple:Press Plugin’s Language Translation ‘mo’ files
    • WARNING: On the Localization codex page, the Language Translation “.mo” Files Overview should be reviewed and well understood for naming convention and language translation file placement.
      • After reviewing the material discussed under the “Language Translation Selection Sequences” heading, the “Manual Installation of Simple:Press Language Translation Files section, follow the steps outlined at “Finding and Storing ANY Simple:Press Plugin’s Language Translation ‘mo’ files”.
      • Each time through the process at the step, “Scroll down the list and click on the name of the plugin whose language files are being sought to see the translation file Version Number available”, substitute “File Uploader” for the phrase “the name of the plugin whose language files are being sought”.
      • Be sure to verify the locale (filename) for the “.mo” file matches the language code for the language as referenced in the “Warning” above. If it does not, change it to match.
      • Repeat the steps for each language it is desired to have a translation file (french, spanish, etc.) for the plugin on the website.

Plugin Usage

Forum users with the proper post “Uploading” permissions can select to upload files of the types they are permitted to upload into the post they are creating.

Note:
Forum users can upload files of the types allowed by the forum Admin according to their permissions. Users with:

  • “Can upload images in posts” permission can upload image files.
  • “Can upload media in posts” permission can upload media files.
  • “Can upload files in posts” permission can upload other types of files.
  • Uploading Files into New Topic Posts
    • Navigate to a forum or a topic and click on the “Add Topic” button to display the “Add Topic” form.
    • At the appropriate time during the development of the post, add the files to be uploaded into the post.
    • Below the text input area for the new post, click on the “Upload Attachments” button to display the “Select Files” popup Window (Upload Pane).
      • The types and sizes of the files allowed to be uploaded are listed right under “drag files here.” section.
    • Get a file to be uploaded into the “File Select” Popup Window (Upload Pane) by one of the following:
      • Clicking the “Add File” button to manually navigate memory storage to find the file to be uploaded. OR
      • From a memory window displaying the file to be uploaded, drag and drop the file into the “File Select” Popup Window (Upload Pane).
    • The file to be uploaded is shown in the “File Select” Popup Window (Upload Pane).
      • To view the file(s) in list form, click the list button in the upper right corner of the “Select Files” popup Window (Upload Pane) header.
        • When hovering over the list button the message “List” is displayed.
      • To view the file(s) as thumbnails, click the thumbnails button in the upper right corner of the “Select Files” popup Window (Upload Pane) header.
        • When hovering over the thumbnail button the message “Thumbnails” is displayed.
    • Repeat the process until all files to be uploaded are in the “File Select” Popup Window (Upload Pane).
      • The “Add Files” button has changed to “‘X’ files queued” where ‘X’ is the number of files already in the “File Select” Popup Window (Upload Pane). This button can be used to add more files.
    • Click the “Start Upload” button to start the upload of the files into the post.
    • If the “Plugin: Post Preview” is active, click the “Preview” button at the bottom of the “Add Topic” form to preview the topic post.
    • When all the desired sections of the post are complete, click on the “Submit Topic” button at the bottom of the form to submit the topic.
    • Depending on the options selected by the forum Admin on the “File Uploader – Settings” forum Admin panel, in the post the files may be shown as thumbnails or have links to them, may appear as attachments at the bottom of the post, or both.
      • Image files shown in the body of the post can be set up so that clicking on the thumbnail results in the image file opening in a popup window.
    Note:
    Depending on the web browser being used, its settings, and the application needed to open a file, clicking on the link to a file or clicking on the attachment may or may not result in the file opening in the existing window or in another window.In some cases the browser may be set up to facilitate downloading the file to the user’s viewing device. The user may then have to navigate to the downloaded file and open it manually.
  • Uploading Files into Reply Posts
    • Navigate to a forum topic and click on the “Add Reply” button to display the “Add Reply” form.
    • At the appropriate time during the development of the post, add the files to be uploaded into the post.
    • Below the text input area for the new post, click on the “Upload Attachments” button to display the “Select Files” popup Window (Upload Pane).
      • The types and sizes of the files allowed to be uploaded are listed right under “drag files here.” section.
    • Get a file to be uploaded into the “File Select” Popup Window (Upload Pane) by one of the following:
      • Clicking the “Add File” button to manually navigate memory storage to find the file to be uploaded. OR
      • From a memory window displaying the file to be uploaded, drag and drop the file into the “File Select” Popup Window (Upload Pane).
    • The file to be uploaded is shown in the “File Select” Popup Window (Upload Pane).
      • To view the file(s) in list form, click the list button in the upper right corner of the “Select Files” popup Window (Upload Pane) header.
        • When hovering over the list button the message “List” is displayed.
      • To view the file(s) as thumbnails, click the thumbnails button in the upper right corner of the “Select Files” popup Window (Upload Pane) header.
        • When hovering over the thumbnail button the message “Thumbnails” is displayed.
    • Repeat the process until all files to be uploaded are in the “File Select” Popup Window (Upload Pane).
      • The “Add Files” button has changed to “‘X’ files queued” where ‘X’ is the number of files already in the “File Select” Popup Window (Upload Pane). This button can be used to add more files.
    • Click the “Start Upload” button to start the upload of the files into the post.
    • If the “Plugin: Post Preview” is active, click the “Preview” button at the bottom of the “Add Reply” form to preview the reply post.
    • When all the desired sections of the post are complete, click on the “Submit Reply” button at the bottom of the form to submit the reply.
    • Depending on the options selected by the forum Admin on the “File Uploader – Settings” forum Admin panel, in the post the files may be shown as thumbnails or have links to them, may appear as attachments at the bottom of the post, or both.
      • Image files shown in the body of the post can be set up so that clicking on the thumbnail results in the image file opening in a popup window.
    Note:
    Depending on the web browser being used, its settings, and the application needed to open a file, clicking on the link to a file or clicking on the attachment may or may not result in the file opening in the existing window or in another window.In some cases the browser may be set up to facilitate downloading the file to the user’s viewing device. The user may then have to navigate to the downloaded file and open it manually.

Forum users with the proper post “Uploading” permission can select to upload files of the types they are permitted to upload to be displayed in the “signature” section of their posts.

Note:
Forum users can upload files of the types allowed by the forum Admin according to their permissions. Users with:

  • “Can upload signature images” permission can upload signature image files.
  • Uploading a Signature File
    • From a Forum page, click on the “Profile” button in the Forum page header to display the logged in user’s profile.
    • Click on the “Profile” tab followed by the “Edit Signature” sub-tab to view the “Edit Signature” profile panel.
    • After typing in any text to be associated with the signature in the text input area, click on the “Upload Image” button below the text input area to display the “Select Files” popup Window (Upload Pane).
      • The types and sizes of the files allowed to be uploaded are listed right under “drag files here.” section.
    • Get a file to be uploaded into the “File Select” Popup Window (Upload Pane) by one of the following:
      • Clicking the “Add File” button to manually navigate memory storage to find the file to be uploaded. OR
      • From a memory window displaying the file to be uploaded, “drag and drop” the file into the “File Select” Popup Window (Upload Pane).
    • The file to be uploaded is shown in the “File Select” Popup Window (Upload Pane).
      • To view the file(s) in list form, click the list button in the upper right corner of the “Select Files” popup Window (Upload Pane) header.
        • When hovering over the list button the message “List” is displayed.
      • To view the file(s) as thumbnails, click the thumbnails button in the upper right corner of the “Select Files” popup Window (Upload Pane) header.
        • When hovering over the thumbnail button the message “Thumbnails” is displayed.
    • Repeat the process until all files to be uploaded are in the “File Select” Popup Window (Upload Pane).
      • The “Add Files” button has changed to “‘X’ files queued” where ‘X’ is the number of files already in the “File Select” Popup Window (Upload Pane). This button can be used to add more files.
    • Click the “Start Upload” button to start the upload of the files into the post.
    • When all the desired files have been uploaded, click on the “Update Signature” button above the “Select Files” popup Window (Upload Pane) to update the signature.
    • The signature text and any signature files uploaded will be displayed at the bottom of all the logged in user’s posts to the extent there is sufficient room in the post’s signature area below the post’s text area.

Forum users with the proper post “Uploading” permission can manage (view, delete) their uploaded attachments from their profile.

Note:
Forum users can upload files of the types allowed by the forum Admin according to their permissions. Users with:

  • “Can manage their uploaded attachments in profile” permission can manage their uploaded attachments from their profile.
  • Managing Uploaded Attachments
    • From a Forum page, click on the “Profile” button in the Forum page header to display the logged in user’s profile.
    • Click on the “Attachments” tab to view the sub-tabs “Image Uploads”, “Media Uploads”, and “File Uploads”.
    • Managing Image Files (Viewing & Deleting)
      • Click on the “Image Uploads” sub-tab to view the “Image Uploads” profile panel showing folders named for the years that uploads were done.
      • Click on the right facing arrowhead to the left of the appropriate “Year” folder to view sub-folders named for the “Months” (01 = January, 02 = February, etc.) for that year that uploads were done.
      • Click on the right facing arrowhead to the left of the appropriate “Month” folder to view the names of the files uploaded during that month.
        • Hovering the cursor over the icon to the left of the uploaded file’s filename causes the thumbnail of the file to be displayed for viewing.
      • To delete a file, click on the file’s filename to highlight it.
        • The “Ctrl” and “Shift” keys can be used to add additional individual files or successive files for deletion, respectively.
      • Click on the “Remove Selected Image Attachments” button at the top or bottom of the list to delete the highlighted files after confirming in the popup message that the selected attachments are to be permanently deleted.
        • The highlighted files are removed from the list within the “Month” folder.
      • Repeat the process to view and, if desired, delete additional attachments in other “Month” folders in the currently selected “Year” or other “Year” folders.
    • Managing Media Files (Viewing & Deleting)
      • Click on the “Media Uploads” sub-tab to view the “Media Uploads” profile panel showing folders named for the years that uploads were done.
      • Click on the right facing arrowhead to the left of the appropriate “Year” folder to view sub-folders named for the “Months” (01 = January, 02 = February, etc.) for that year that uploads were done.
      • Click on the right facing arrowhead to the left of the appropriate “Month” folder to view the names of the files uploaded during that month.
      • To delete a file, click on the file’s filename to highlight it.
        • The “Ctrl” and “Shift” keys can be used to add additional individual files or successive files for deletion, respectively.
      • Click on the “Remove Selected Media Attachments” button at the top or bottom of the list to delete the highlighted files after confirming in the popup message that the selected attachments are to be permanently deleted.
        • The highlighted files are removed from the list within the “Month” folder.
      • Repeat the process to view and, if desired, delete additional attachments in other “Month” folders in the currently selected “Year” or other “Year” folders.
    • Managing Other Files (Viewing & Deleting)
      • Click on the “File Uploads” sub-tab to view the “File Uploads” profile panel showing folders named for the years that uploads were done.
      • Click on the right facing arrowhead to the left of the appropriate “Year” folder to view sub-folders named for the “Months” (01 = January, 02 = February, etc.) for that year that uploads were done.
      • Click on the right facing arrowhead to the left of the appropriate “Month” folder to view the names of the files uploaded during that month.
      • To delete a file, click on the file’s filename to highlight it.
        • The “Ctrl” and “Shift” keys can be used to add additional individual files or successive files for deletion, respectively.
      • Click on the “Remove Selected File Attachments” button at the top or bottom of the list to delete the highlighted files after confirming in the popup message that the selected attachments are to be permanently deleted.
        • The highlighted files are removed from the list within the “Month” folder.
      • Repeat the process to view and, if desired, delete additional attachments in other “Month” folders in the currently selected “Year” or other “Year” folders.

Plugin Special Notes

Depending on the web browser being used, its settings, and the application needed to open a file, clicking on the link to a file or clicking on the attachment may or may not result in the file opening in the existing window or in another window.

In some cases the browser may be set up to facilitate downloading the file to the user’s viewing device. The user may then have to navigate to the downloaded file and open it manually.

Template Tags Used in the Plugin

There are no Template Tags used in this plugin.

Actions and Hooks Used in the Plugin

There are no Actions and Hooks available in Template Tags for this plugin.

There are other Actions and Hooks available in this plugin to modify aspects of file uploading.
In file ‘sp-plupload-plugin.php‘: Two (2) apply_filters(‘sph_…) are available.
In file ‘sp-plupload-forms.php‘: Six (6) apply_filters(‘sph_…) are available.
In file ‘sp-plupload-ahah-manage.php‘: Two (2) apply_filters(‘sph_…) are available.
In file ‘sp-plupload-files-form.php‘: Five (5) apply_filters(‘sph_…) are available.
In file ‘sp-plupload-images-form.php‘: Five (5) apply_filters(‘sph_…) are available.
In file ‘sp-plupload-media-form.php‘: Five (5) apply_filters(‘sph_…) are available.
In file ‘sp-plupload-components.php‘: Two (2) apply_filters(‘sph_…) are available.
In file ‘sp-plupload-admin-options-save.php‘: One (1) do_action(‘sph_…) is available.

Plugin and Template Tag Changelog

Since Simple:Press version 5.0.
SP Version 5.6.4 and Plugin Version 4.3.2: Added filters for main editor buttons; Two (2) filters in ‘sp-plupload-plugin.php’ and more three (3) filters in ‘sp-plupload-forms.php’.

Codex page sync’d to code version 5.6.4 and plugin version 4.3.2

More Topics In SimplePress: Plugins


Copyright © 2006-2019 Simple:Press. All Rights Reserved.