=== Parallax Image === Contributors: thehowarde Donate link: https://www.duckdiverllc.com/parallax-image-plugin/ Tags: Parallax, Full Screen Parallax, Parallax Window, Parallax Image Requires at least: 4.5 Tested up to: 4.8 Stable tag: 1.2 License: GPLv3 License URI: https://www.gnu.org/licenses/gpl-3.0.html Insert a full width parallax image into your page with this simple shortcode. Parameters allow for setting several key functions like height == Description == This is a simple parallax image plugin that uses the parallax.js script by pixelcog - http://pixelcog.github.io/parallax.js/ To insert your full width parallax image, simply use the [dd-parallax] shortcode. Include text to be overlaid on the parallax between the open and close [/dd-parallax] code. This plugin has been tested with Wordpress 2014, 2015, 2016, and 2017 themes as well as a few themes that use Bootstrap. I can't guarantee that it will work with all themes, but it's worth a shot. For example: `[dd-parallax img="imagename.jpg" height="600" speed="3" z-index="-100" mobile="mobile-image.jpg"] Text to be overlaid on the paralllax window [/dd-parallax]` Available parameters for use: * img - use the filename from the media library for this, not the full path. Just use imagename.jpg or image.png. * height - This is the height of the parallax window. The unit is in pixels. Just enter a number * speed [optional] (default = 2) An integer between 0 and 10. The speed at which the parallax effect runs. 0 means the image will appear fixed in place, and 10 the image will flow at the same speed as the page content. * z-index [optional] (defulat = 0) - The z-index value of the fixed-position elements. By default these will be behind everything else on the page. * mobile [optional] - If you want a mobile fixed image for mobile display, choose a different image, otherwise it will select the full sized image from the parallax and make it a responsive image. == Demo == View a demo of this plugin [here](https://www.duckdiverllc.com/parallax-image-plugin-demo/) == Frequently Asked Questions == = I'm not seeing the image on the screen, what did I do wrong? = For this - there are 2 probable reasons that you're not seeing the parallax. * First - Check to make sure that your img is only the file name, and not the full path. If you view the media library in "list" mode yourdomain.com/wp-admin/upload.php?mode=list - there you'll see the filename with the .jpg or .png extension. * Second - If not the first answer. Check your z-index. Changing the z-index will adjust the layering of your screen with CSS, and may need to be changed depending on how your theme displays the backgrounds and colors. For more about z-index - [w3schools](https://www.w3schools.com/cssref/pr_pos_z-index.asp) = Can I have multiple parallax images on each page. = Yes = Will this work on mobile devices = For mobile devices, you can either have a totally separate mobile image by using the ‘mobile’ parameter in the shortcode, or you can just have the main parallax image resize itself and be responsive. = While I’m debugging, the mobile test doesn’t look right = If you’re resizing your browser window to check for responsiveness, the plugin uses mobile_detect, so you must either spoof your user agent, or test on a real mobile device. You might have to refresh for it to work right. == Installation == 1. Upload the plugin files to the `/wp-content/plugins/parallax-image` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the 'Plugins' screen in WordPress. == Screenshots == 1. The shortcode implemented with the WordPress Twenty-Sixteen Theme 2. Editor view of shortcode usage. 3. A Parallax Window on a bootstrap theme with fullwidth template. == Changelog == = 1.2 = Added mobile_detect and mobile options to make the image responsive for mobile display and render better on mobile. Added 'mobile' parameter to the shortcode as an option. = 1.1.1 = Added a Space to the style block to correct = 1.1 = Fixed Error = 1.0.2 = Removed extra js to keep lightweight = 1.0.1 = * Update Plugin URI = 1.0 = * Initial Release Version