OneDrive Gallery & File Documentation for Joomla

WordPress plugin
  1. Component configuration

    Register your site in Windows Live application management that Joomla could connect to your OneDrive.
    Remember to set Redirect URL as shown in component configuration and Mobile client app: No.
    Read how to get your Client ID.

    Each time you would change Joomla! Global Configuration - SEO Settings, Redirect URL will change and you will have to update it in Windows Live Application.

  2. OneDrive buttons are missing

    If all OneDrive editor buttons and content plugins are enabled and you do not see OneDrive buttons under article editor or nothing happens after click on it, then you have to use another editor, for example default Joomla! TinyMCE, because either your current editor do not support Joomla! Editor Buttons or it has some options where you can enable them.

  3. First run of OneDrive buttons

    Disable pop-up windows blocking, because OneDrive would display login and permissions screen in a new pop-up window.

  4. Advanced configuration

    In Joomla there are available 3 HTTP adapters: curl, socket and stream. Adapters are used for sending request to OneDrive to get files for your site. Not all adapters will be available on all servers. If you can not download inserted file or display gallery then try to change HTTP adapter. You might need also to enable option Redirect image.

    If you have problems with displaying files and images on your site then enable Debug mode.

  5. Blank Lightbox or error

    If you clicked OneDrive button below article editor and nothing has happened after a few minutes or a blank Lightbox window has display with message: Error Microsoft OneDrive, then remove cookie named: wl_auth and reload article edit page.

    Use OneDrive emergency exit button to close all blank layers.

    Remember to save article before using OneDrive buttons or at least before reloading page.

  6. Microsoft account is experiencing technical problems

    Since plugin version 1.1.0 there is a new Redirect URL. Make sure you have updated it! You can also enable Enhanced redirection security in old Windows Live applications - created before June 2014.

    Each time you would change Joomla! Global Configuration - SEO Settings, Redirect URL will change and you will have to update it in Windows Live Application. Make sure that it is up to date.

    If you get such message in popup window then check error_description of URL in address bar.

    If you have following error description:
    The provided value for the input parameter 'redirect_uri' is not valid. The expected value is 'https://login.live.com/oauth20_desktop.srf' or a URL which matches the redirect URI registered for this client application
    then make sure that you have plugin version 1.1.0 or newer
    and you have set the same Redirect URL in Windows Live application management as in plugin configuration.

    Make sure that if you have set in Windows Live application management Redirect URL with www then you access back-end and front-end site also with www otherwise it would not work.
    If it is possible to access your site with and without www then you should correct it in .htaccess file and allow only one way.

    If you have other error description then send it to our support.

  7. Debugging

    Go to OneDrive component configuration and enable debug mode in Advanced tab.

    Go back to Article editor. Remove wl_auth cookie. Reload page. Try to use OneDrive button again. You will see some alerts with debug informations.

    Check also /logs/onedrive.log.php or /logs/error.php file locate in root path of your Joomla. Read only lines with onedrive or skydrive. If you would not find there any error message then send this log file to our support.

  8. Gallery plugin special options

    Plugin syntax: {skydrivegallery folder.id} or {skydrivegallery folder.id {settings}}

    folder.id - can only be inserted by Perfect OneDrive Gallery button below article editor. Do not write it manually because access token would not be saved in database and gallery would not work.
    settings - can be replaced with following options. Each option has to be separated with , (coma). After last option do not put separator.

    • animation_speed: 'fast' - fast / slow / normal
    • slideshow: 5000 - FALSE OR interval time in ms
    • autoplay_slideshow: false - TRUE / FALSE
    • opacity: 0.80 - Value between 0 and 1
    • show_title: true - TRUE / FALSE
    • allow_resize: true - Resize the photos bigger than viewport. TRUE / FALSE
    • default_width: 500
    • default_height: 344
    • counter_separator_label: '/' - The separator for the gallery counter 1 'of' 2
    • theme: 'pp_default' - light_rounded / dark_rounded / light_square / dark_square / facebook
    • horizontal_padding: 20 - The padding on each side of the picture
    • hideflash: false - Hides all the flash object on a page, set to TRUE if flash appears over prettyPhoto
    • wmode: 'opaque' - Set the flash wmode attribute
    • autoplay: true - Automatically start videos: TRUE / FALSE
    • modal: false - If set to TRUE, only the close button will close the window
    • deeplinking: true - Allow prettyPhoto to update the url to enable deeplinking.
    • overlay_gallery: true - If set to TRUE, a gallery will overlay the fullscreen image on mouse over
    • keyboard_shortcuts: true - Set to FALSE if you open forms inside prettyPhoto

    You can also use other settings available for prettyPhoto which do not use character { or }.

  9. File plugin special options

    Plugin syntax: {skydrivefile file.id} or {skydrivefile file.id settings}

    file.id - can only be inserted by Perfect OneDrive File button below article editor. Do not write it manually because access token would not be saved in database and file would not work.
    settings - can be replaced with following options. Each option has to be separated with space.

    • image=normal - set image size: thumbnail, album, normal, full or set: download to display image as link
    • width=100 - width of image
    • height=100 - height of image
    • class=class_name - CSS class for image or link tag
    • name=File description - Name of file or alternative text for image. This option has to be always the last one, because it can contain spaces!
  10. Good practices in using OneDrive buttons

    Save article before using OneDrive buttons. Disable pop-up windows blocking.

  11. sh404SEF

    Change configuration of sh404SEF that it would use Joomla! router for Perfect OneDrive component and would not add language code to URL.

    Preview configuration