Simple:Press Documentation

Plugin: Uploads Viewer

Plugin Description

The Simple:Press Uploads Viewer plugin allows the forum users to view their previous uploads and insert those existing uploads into other posts.

Note:
The Simple:Press Plugin: File Uploader (aka “Image, Media, and File Uploader” or “File Uploader with Plupload”) MUST be installed, activated, its options set, and its permissions set before this plugin can be used.Additionally, image files, media files, and ‘other’ files to be viewed and used by this plugin must have already been uploaded using the Plugin: File Uploader.

Plugin Features

Installing this Simple:Press plugin adds:

  • A new Uploads Viewer 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 “uploads-viewer” containing the plugin’s files.

Activating this plugin provides:

  • A change to the new “Uploads Viewer” section in the Plugin Management panel under the Admin menu path Forum > Plugins > Available Plugins so the plugin can be deactivated.
    • There are no options for this plugin.
    • The “Getting Started” link associated with the “Deactivate” selections should be selected to view the pertinent information regarding the plugin.
  • In the “Add Topic” post form three (3) new buttons below the post text input area join the “Upload Attachments” button from the required Plugin: File Uploader.
    • A new “View Existing Image Uploads” button when clicked displays the “View Existing Image Uploads” popup window where existing image files can be reviewed and added to the content of post.
    • A new “View Existing Media Uploads” button when clicked displays the “View Existing Media Uploads” popup window where existing media files can be reviewed and added to the content of post.
    • A new “View Existing File Uploads” button when clicked displays the “View Existing File Uploads” popup window where links to existing ‘other’ files can be reviewed and added to the content of post.
  • In the “Add Reply” post form three (3) new buttons below the post text input area join the “Upload Attachments” button from the required Plugin: File Uploader.
    • A new “View Existing Image Uploads” button when clicked displays the “View Existing Image Uploads” popup window where existing image files can be reviewed and added to the content of post.
    • A new “View Existing Media Uploads” button when clicked displays the “View Existing Media Uploads” popup window where existing media files can be reviewed and added to the content of post.
    • A new “View Existing File Uploads” button when clicked displays the “View Existing File Uploads” popup window where links to existing ‘other’ files can be reviewed and added to the content of post.

There are no new permissions added to the permission sets

Plugin Requirements

Simple:Press version 5.5.4 and above is required.

This plugin requires that the Simple:Press Plugin: File Uploader (aka “Image, Media, and File Uploader” or “File Uploader with Plupload”) is installed, activated, and its options already set before this plugin is activated.

Additionally, image files, media files, and ‘other’ files to be viewed and used by this plugin must have already been uploaded by the user using the Plugin: File Uploader.

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

As part of the installation, a “Uploads Viewer” 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, or deleted.

  • There are no options that need be set up for this plugin.

There are no new permissions added to the permission sets due to this plugin.

The plugin does not have template tags so no recommendation regarding Custom or Child Themes is being made.

Plugin Installation and Activation

Please see Using Plugins on how to obtain and install the Plugin: File Uploader (aka “Image, Media, and File Uploader” or “File Uploader with Plupload”).

  • Please see the plugin’s Codex page at the link immediately above in this paragraph for set up and use of the plugin to upload files that must be in place before this plugin can be used effectively.

Please see Using Plugins on 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 “uploads-viewer“.
  • 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 “uploads-viewer.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 Uploads Viewer plugin and click on “Activate”. The “Activate/Delete” label changes to “Deactivate” with a “Get Started” Link.

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

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

Plugin Administrative Options

After installing and activating, there are no Administrative Options to be set for this plugin.

There are no new permissions that must be set in the permission sets because of this plugin.

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 Uploads Viewer 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 “Uploads Viewer” 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 “Uploads Viewer” 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

Note:
Before this plugin can have access to image files, media files, and ‘other’ files for a given user, those files must have previously been uploaded to posts by that user using the Plugin: File Uploader.

The forum user with the correct permissions can view and reuse files they have previously uploaded to earlier posts in new or edited posts.

In New Topic Posts

Note:
When developing a new Topic post and at the point in the post a previously uploaded file is to be used, go to the appropriate paragraph of the three (3) immediately below to add the specific category of file.
    • In New Topic Posts View the List and/or Add Image Files Previous Uploaded
Note:
Forum user with the “Can upload images in posts” permission must have uploaded image files to previous posts before performing these steps.
    • If not already done, 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 previously uploaded image files into the post being sure to have the cursor at the location in the post where the image file is to be added.
    • Click on the “View Existing Image Uploads” button in the area under the post text box to display the “Viewing Existing Image Uploads” popup window where image folders named for the year (e.g. 2015, 2016) images files were uploaded are shown.
    • Click on the name of the year folder (e.g. 2015, 2016) to see sub-folders named for the months (e.g. 01 = January, 11 = November) image files were uploaded.
    • Click on the name of the month folder (e.g. 01) to display the image files uploaded in that month of the year.
      • Hovering the cursor over the image file name will result in a thumbnail of the image being displayed.
    • Click on the file name of the image to be inserted into the post to have the image placed in the post at the cursor position in the post.
      • Multiple files can be inserted by finding them in folders and clicking on them.
      • Clicking inside the image file in the post allows the post author to size the image file in the post by dragging the corners of the image in or out.
    • Close the popup window, add any text to the post, and then repeat the steps to add any other images until all desired images have been added to the post.
    • If there are other categories of previously uploaded files to be added to the post, proceed to the appropriate section below to add those files, otherwise complete the remaining sections of the post and click the “Submit Topic” button at the bottom of the post to submit the post.
    • In New Topic Posts View the List and/or Add Media Files Previous Uploaded
Note:
Forum user with the “Can upload media in posts” permission must have uploaded media files to previous posts before performing these steps.
    • If not already done, 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 previously uploaded media files into the post being sure to have the cursor at the location in the post where the media file is to be added.
    • Click on the “View Existing Media Uploads” button in the area under the post text box to display the “Viewing Existing Media Uploads” popup window where folders named for the year (e.g. 2015, 2016) media files were uploaded are shown.
    • Click on the name of the year folder (e.g. 2015, 2016) to see sub-folders named for the months (e.g. 01 = January, 11 = November) media files were uploaded.
    • Click on the name of the month folder (e.g. 01) to display the media files uploaded in that month of the year.
    • Click on the file name of the media to be inserted into the post to have the media placed in the post at the cursor position in the post.
      • Multiple files can be inserted by finding them in folders and clicking on them.
    • Close the popup window, add any text to the post, and then repeat the steps to add any other media files until all desired media have been added to the post.
    • If there are other categories of previously uploaded files to be added to the post, proceed to the appropriate section below or above to add those files, otherwise complete the remaining sections of the post and click the “Submit Topic” button at the bottom of the post to submit the post.
    • In New Topic Posts View the List and/or Add ‘Other’ Files Previous Uploaded
Note:
Forum user with the “Can upload files in posts” permission must have uploaded ‘other’ files to previous posts before performing these steps.
    • If not already done, 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 previously uploaded ‘other’ files into the post being sure to have the cursor at the location in the post where the ‘other’ file is to be added.
    • Click on the “View Existing File Uploads” button in the area under the post text box to display the “Viewing Existing File Uploads” popup window where folders named for the year (e.g. 2015, 2016) ‘other’ files were uploaded are shown.
    • Click on the name of the year folder (e.g. 2015, 2016) to see sub-folders named for the months (e.g. 01 = January, 11 = November) ‘other’ files were uploaded.
    • Click on the name of the month folder (e.g. 01) to display the ‘other’ files uploaded in that month of the year.
    • Click on the file name of the ‘other’ file to have a link to the ‘other’ file placed in the post at the cursor position in the post.
      • Multiple files can be inserted by finding them in folders and clicking on them.
    • Close the popup window, add any text to the post, and then repeat the steps to add any other links to ‘other’ files until all desired links to ‘other’ files have been added to the post.
    • If there are other categories of previously uploaded files to be added to the post, proceed to the appropriate section below or above to add those files, otherwise complete the remaining sections of the post and click the “Submit Topic” button at the bottom of the post to submit the post.

In New Reply Posts

Note:
When developing a Reply post and at the point in the post a previously uploaded file is to be used, go to the appropriate paragraph of the three (3) immediately below to add the specific category of file.
    • In New Reply Posts View and/or Add Image Files Previous Uploaded
Note:
Forum user with the “Can upload images in posts” permission must have uploaded image files to previous posts before performing these steps.
    • If not already done, navigate to a topic in a forum 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 previously uploaded image files into the post being sure to have the cursor at the location in the post where the image file is to be added.
    • Click on the “View Existing Image Uploads” button in the area under the post text box to display the “Viewing Existing Image Uploads” popup window where image folders named for the year (e.g. 2015, 2016) images files were uploaded are shown.
    • Click on the name of the year folder (e.g. 2015, 2016) to see sub-folders named for the months (e.g. 01 = January, 11 = November) image files were uploaded.
    • Click on the name of the month folder (e.g. 01) to display the image files uploaded in that month of the year.
      • Hovering the cursor over the image file name will result in a thumbnail of the image being displayed.
    • Click on the file name of the image to be inserted into the post to have the image placed in the post at the cursor position in the post.
      • Multiple files can be inserted by finding them in folders and clicking on them.
      • Clicking inside the image file in the post allows the post author to size the image file in the post by dragging the corners of the image in or out.
    • Close the popup window, add any text to the post, and then repeat the steps to add any other images until all desired images have been added to the post.
    • If there are other categories of previously uploaded files to be added to the post, proceed to the appropriate section below to add those files, otherwise complete the remaining sections of the post and click the “Submit Reply” button at the bottom of the post to submit the post.
    • In New Reply Posts View and/or Add Media Files Previous Uploaded
Note:
Forum user with the “Can upload media in posts” permission must have uploaded media files to previous posts before performing these steps.
    • If not already done, navigate to a topic in a forum and click on the “Add Topic” button to display the “Add Reply” form.
    • At the appropriate time during the development of the post, add the previously uploaded media files into the post being sure to have the cursor at the location in the post where the media file is to be added.
    • Click on the “View Existing Media Uploads” button in the area under the post text box to display the “Viewing Existing Media Uploads” popup window where folders named for the year (e.g. 2015, 2016) media files were uploaded are shown.
    • Click on the name of the year folder (e.g. 2015, 2016) to see sub-folders named for the months (e.g. 01 = January, 11 = November) media files were uploaded.
    • Click on the name of the month folder (e.g. 01) to display the media files uploaded in that month of the year.
    • Click on the file name of the media to be inserted into the post to have the media placed in the post at the cursor position in the post.
      • Multiple files can be inserted by finding them in folders and clicking on them.
    • Close the popup window, add any text to the post, and then repeat the steps to add any other media files until all desired media have been added to the post.
    • If there are other categories of previously uploaded files to be added to the post, proceed to the appropriate section below or above to add those files, otherwise complete the remaining sections of the post and click the “Submit Reply” button at the bottom of the post to submit the post.
    • In New Reply Posts View and/or Add ‘Other’ Files Previous Uploaded
Note:
Forum user with the “Can upload files in posts” permission must have uploaded ‘other’ files to previous posts before performing these steps.
    • If not already done, navigate to a topic in a forum and click on the “Add Topic” button to display the “Add Reply” form.
    • At the appropriate time during the development of the post, add the previously uploaded ‘other’ files into the post being sure to have the cursor at the location in the post where the ‘other’ file is to be added.
    • Click on the “View Existing File Uploads” button in the area under the post text box to display the “Viewing Existing File Uploads” popup window where folders named for the year (e.g. 2015, 2016) ‘other’ files were uploaded are shown.
    • Click on the name of the year folder (e.g. 2015, 2016) to see sub-folders named for the months (e.g. 01 = January, 11 = November) ‘other’ files were uploaded.
    • Click on the name of the month folder (e.g. 01) to display the ‘other’ files uploaded in that month of the year.
    • Click on the file name of the ‘other’ file to have a link to the ‘other’ file placed in the post at the cursor position in the post.
      • Multiple files can be inserted by finding them in folders and clicking on them.
    • Close the popup window, add any text to the post, and then repeat the steps to add any other links to ‘other’ files until all desired links to ‘other’ files have been added to the post.
    • If there are other categories of previously uploaded files to be added to the post, proceed to the appropriate section below or above to add those files, otherwise complete the remaining sections of the post and click the “Submit Reply” button at the bottom of the post to submit the post.

Plugin Special Notes

None

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 no other Actions and Hooks available in this plugin to modify aspects of this plugin.

Plugin and Template Tag Changelog

Since Simple:Press version 5.0.

Codex page sync’d to code version 5.6.3 and plugin version 1.1.13

More Topics In SimplePress: Plugins


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