WPD - WordPress plugin for Dropbox files
display and manage Dropbox shared files, for WordPress user's pages

return to w3all WPD Home
Requirements:
1) The URL of the online WP site where plugin will be installed need to be https
2) System: Php 5.4 or better and WP 4.0 or better
3) Skills: how to use an FTP program and how to use a text editor

Installation time: 10 min
Please read: the w3all WPD WordPress plugin will not be completely active until your online web site isn't linked to the w3all Dropbox App.
You can install and test it on a localhost server (also using http and not https, which is instead required for the online URL), while to completely work on your online https site, the URL of your https site need to be added/linked. Do not install the plugin into your online site until it has not been linked to the w3all Dropbox App. Will not work.
You'll receive a confirmation email as your site has been added/linked.
If you still have not received the site addition confirmation email, please send your site addition request including the envato.com purchase details and your site https URL to: plugins@w3tasks.com.
INSTALLATION
If any problem on executing the 3 easy template steps below about to edit the Dropbox template page for your WordPress theme, please just send the file page.php of your WordPress theme to this email address: plugins@w3tasks.com. You'll receive an answer as soon containing the already adapted/modified page-dropbox.php file to be added inside your WordPress theme folder. This is included and free of charge.

For any request, custom install, or more customizations, please send an email with detailed info to the same above email address.

Install the plugin in WordPress

1 - Unzip the file w3all-wordpress-wdp-plugin.zip
You'll have
w3all-WPD-WordPress-Dropbox/WPD Plugin/wpd-w3all-dropbox

Upload only the wpd-w3all-dropbox folder inside your WordPress
wp-content/plugins folder

2 - Open your WordPress Admin and from left Admin menu choose > Plugins > Installed Plugins
Activate the WPD - WordPress Dropbox


3 - Now from left Admin menu choose > Settings > WPD w3all Dropbox
Follow instructions hints on the config page to setup the configuration settings for the plugin, and setup options



The Page Template part

1 - Open your WordPress Admin and from left Admin menu choose > Pages > Add New. As title, insert dropbox. The page need to be created blank, do not put any content. Only title it dropbox. Click Publish.


2 - Open folder
wp-content/themes/YOUR_ACTIVE_THEME_NAME_FOLDER

Duplicate (copy/paste in the same template folder) the file page.php, renaming the new copied file into page-dropbox.php.
So now, into your wp-content/themes/YOUR_ACTIVE_THEME_NAME_FOLDER you'll have page.php AND page-dropbox.php.


3 - Open with a text editor the file
wp-content/themes/YOUR_ACTIVE_THEME_NAME_FOLDER/page-dropbox.php you've just created.

Immediately after the very first code line:
<?php

add the follow:
require_once( WP3ALL_DROPBOX_PLUGIN_DIR . 'w3all_dropbox_content_bootst.php' );


Now, depending on how your WordPress template page is done, it is necessary to put inside correct tags, which normally are:
<main id="main" class="site-main" role="main">
  
 </main><!-- .site-main -->
the following code that display the Wp_w3all Dropbox Wrapper:

<?php require_once( WP3ALL_DROPBOX_PLUGIN_DIR . 'w3all_dropbox_content_dbx_wrapper.php' ); ?>

For example, on a default WordPress theme page, like on Twentysixteen theme (as well on all others default WordPress template pages), you'll see this code, that display the main center page content:
<main id="main" class="site-main" role="main">
		<?php
		
		// Start the loop.
		while ( have_posts() ) : the_post();

			// Include the page content template.
			get_template_part( 'template-parts/content', 'page' );

			// If comments are open or we have at least one comment, load up the comment template.
			if ( comments_open() || get_comments_number() ) {
				comments_template();
			}

			// End of the loop.
		endwhile;
		?>

</main><!-- .site-main -->
Remove all code inside tags:
<main id="main" class="site-main" role="main">

</main><!-- .site-main -->
and replace it with:
<?php require_once( WP3ALL_DROPBOX_PLUGIN_DIR . 'w3all_dropbox_content_dbx_wrapper.php' ); ?>
so the resulting code for page-dropbox.php about center content will look like this:
<main id="main" class="site-main" role="main">
  <?php require_once( WP3ALL_DROPBOX_PLUGIN_DIR . 'w3all_dropbox_content_dbx_wrapper.php' ); ?>
 </main><!-- .site-main -->
Save the file page-dropbox.php.



Customize CSS for user frontend manager, files list and buttons

Note: File's list separator color, Thumbnail size and WordPress Dropbox page name are options to be set on plugin's configuration page.
All should appear and look like others elements of the installed/active WP theme layout.
But if you wish to edit front end Dropbox files list wrapper and files manager user's buttons layout, you can do it by opening files

CSS:
wp-content/plugins/wpd-w3all-dropbox/views/style.css
HTML:
wp-content/plugins/wpd-w3all-dropbox/w3all_dropbox_content_dbx_wrapper.php
plugins.w3tasks.com