<?php //phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
* Presentations plugin based on the work done by <a href="http://darylkoop.com/">Daryl Koopersmith</a>. Powered by jmpress.js
* HOW TO: How the plugin settings are organized and which features are supported.
* The entire presentation should be wrapped with a [presentation] shortcode, and every
* individual slide should be wrapped with a [slide] shortcode. Any settings supported
* by [slide] can be set into [presentation], which will apply that setting for the entire
* presentation unless overridden by individual slides.
* - [presentation] only settings:
* - duration: transition durations, default is one second.
* - height: content height, default is 400px
* - width: content width, default is 550px
* - autoplay: delay between transitions in seconds, default 3s
* when set the presentation will automatically transition between slides
* as long as the presentation remains in focus
* - transition: specifies where the next slide will be placed relative
* to the last one before it. Supported values are "up", "down"
* "left", "right", or "none". Default value is "down".
* - scale: scales the content relative to other slides, default value is one
* - rotate: rotates the content by the specified degrees, default is zero
* - fade: slides will fade in and out during transition. Values of "on" or
* "true" will enable fading, while values of "no" or "false" will
* disable it. Default value is "on"
* - bgcolor: specifies a background color for the slides. Any CSS valid value
* is permitted. Default color is transparent.
* - bgimg: specifies an image url which will fill the background. Image is
* set to fill the background 100% width and height
* - fadebullets: any html <li> tags will start out with an opacity of 0 and any
* subsequent slide transitions will show the bullets one by one
* - IE 7/8 are not supported by jmpress and presentations will not work
* - IE 9 will not animate transitions at all, though it's possible to at least
* - Infinite Scroll themes will not load presentations properly unless the post
* happens to be on the first loaded page. The permalink page will function
* - Exiting fullscreen mode will not properly reset the scroll locations in Safari
* @package automattic/jetpack
use Automattic\Jetpack\Assets;
if ( ! defined( 'ABSPATH' ) ) {
if ( ! class_exists( 'Presentations' ) ) :
* Create a shortcode to display Presentations and slides.
private $presentation_settings;
* Do we have a Presentation shortcode to be displayed.
private $presentation_initialized;
* Were scripts and styles enqueued already.
private $scripts_and_style_included;
public function __construct() {
$this->presentation_initialized = false;
$this->scripts_and_style_included = false;
add_action( 'wp_head', array( $this, 'add_scripts' ), 1 );
add_shortcode( 'presentation', array( $this, 'presentation_shortcode' ) );
add_shortcode( 'slide', array( $this, 'slide_shortcode' ) );
* Enqueue all scripts and styles.
public function add_scripts() {
$this->scripts_and_style_included = false;
if ( empty( $GLOBALS['posts'] ) || ! is_array( $GLOBALS['posts'] ) ) {
foreach ( $GLOBALS['posts'] as $p ) {
if ( isset( $p->post_content ) && has_shortcode( $p->post_content, 'presentation' ) ) {
$this->scripts_and_style_included = true;
if ( ! $this->scripts_and_style_included ) {
$plugin = plugin_dir_url( __FILE__ );
wp_enqueue_style( 'presentations', $plugin . 'css/style.css', array(), JETPACK__VERSION );
wp_enqueue_script( 'jquery' );
Assets::get_file_url_for_environment( '_inc/build/shortcodes/js/jmpress.min.js', 'modules/shortcodes/js/jmpress.js' ),
Assets::get_file_url_for_environment( '_inc/build/shortcodes/js/main.min.js', 'modules/shortcodes/js/main.js' ),
array( 'jquery', 'jmpress' ),
* Main Presentation shortcode.
* @param array $atts Shortcode attributes.
* @param string $content Post content.
public function presentation_shortcode( $atts, $content = '' ) {
// Mark that we've found a valid [presentation] shortcode.
$this->presentation_initialized = true;
$this->presentation_settings = array(
// Set the presentation-wide settings.
if ( '' !== trim( $atts['transition'] ) ) {
$this->presentation_settings['transition'] = $atts['transition'];
if ( '' !== trim( $atts['scale'] ) ) {
$this->presentation_settings['scale'] = (float) $atts['scale'];
if ( '' !== trim( $atts['rotate'] ) ) {
$this->presentation_settings['rotate'] = (float) $atts['rotate'];
if ( '' !== trim( $atts['fade'] ) ) {
$this->presentation_settings['fade'] = $atts['fade'];
if ( '' !== trim( $atts['fadebullets'] ) ) {
$this->presentation_settings['fadebullets'] = $atts['fadebullets'];
// Set any settings the slides don't care about.
if ( '' !== trim( $atts['duration'] ) ) {
$duration = (float) $atts['duration'] . 's';
// Autoplay durations are set in milliseconds.
if ( '' !== trim( $atts['autoplay'] ) ) {
$autoplay = (float) $atts['autoplay'] * 1000;
// Set the presentation size as specified or with some nicely sized dimensions.
if ( '' !== trim( $atts['width'] ) ) {
$this->presentation_settings['width'] = (int) $atts['width'];
$this->presentation_settings['width'] = 480;
if ( '' !== trim( $atts['height'] ) ) {
$this->presentation_settings['height'] = (int) $atts['height'];
$this->presentation_settings['height'] = 370;
// Hide the content by default in case the scripts fail.
$style = 'display: none; width: ' . $this->presentation_settings['width'] . 'px; height: ' . $this->presentation_settings['height'] . 'px;';
* Check for background color XOR background image
* Use a white background if nothing specified
if ( preg_match( '/https?\:\/\/[^\'"\s]*/', $atts['bgimg'], $matches ) ) {
$style .= ' background-image: url("' . esc_url( $matches[0] ) . '");';
} elseif ( '' !== trim( $atts['bgcolor'] ) ) {
$style .= ' background-color: ' . esc_attr( $atts['bgcolor'] ) . ';';
$style .= ' background-color: #fff;';
// Not supported message style is inlined incase the style sheet doesn't get included.
$out = "<section class='presentation-wrapper'>";
$out .= "<p class='not-supported-msg' style='display: inherit; padding: 25%; text-align: center;'>";
$out .= __( 'This slideshow could not be started. Try refreshing the page or viewing it in another browser.', 'jetpack' ) . '</p>';
'<div class="presentation" duration="%s" data-autoplay="%s" style="%s">',
$out .= "<div class='nav-arrow-left'></div>";
$out .= "<div class='nav-arrow-right'></div>";
$out .= "<div class='nav-fullscreen-button'></div>";
$out .= '<div class="autoplay-overlay" style="display: none;"><p class="overlay-msg">';
$out .= __( 'Click to autoplay the presentation!', 'jetpack' );
$out .= do_shortcode( $content );
$this->presentation_initialized = false;
* @param array $atts Shortcode attributes.
* @param string $content Post content.
public function slide_shortcode( $atts, $content = '' ) {
// Bail out unless wrapped by a [presentation] shortcode.
if ( ! $this->presentation_initialized ) {
// Determine positioning based on transition.
if ( '' === trim( $atts['transition'] ) ) {
$atts['transition'] = $this->presentation_settings['transition'];
// Setting the content scale.
if ( '' === trim( $atts['scale'] ) ) {
$atts['scale'] = $this->presentation_settings['scale'];
if ( '' === trim( $atts['scale'] ) ) {
$scale = (float) $atts['scale'];
// Setting the content rotation.
if ( '' === trim( $atts['rotate'] ) ) {
$atts['rotate'] = $this->presentation_settings['rotate'];
if ( '' === trim( $atts['rotate'] ) ) {
$rotate = (float) $atts['rotate'];
// Setting if the content should fade.
if ( '' === trim( $atts['fade'] ) ) {
$atts['fade'] = $this->presentation_settings['fade'];
if ( 'on' === $atts['fade'] || 'true' === $atts['fade'] ) {
// Setting if bullets should fade on step changes.
if ( '' === trim( $atts['fadebullets'] ) ) {
$atts['fadebullets'] = $this->presentation_settings['fadebullets'];
if ( 'on' === $atts['fadebullets'] || 'true' === $atts['fadebullets'] ) {
$fadebullets = 'fadebullets';
$coords = $this->get_coords(
'transition' => $atts['transition'],
* Check for background color XOR background image
* Use a white background if nothing specified
if ( preg_match( '/https?\:\/\/[^\'"\s]*/', $atts['bgimg'], $matches ) ) {
$style = 'background-image: url("' . esc_url( $matches[0] ) . '");';
} elseif ( '' !== trim( $atts['bgcolor'] ) ) {
$style = 'background-color: ' . esc_attr( $atts['bgcolor'] ) . ';';
// Put everything together and let jmpress do the magic!
'<div class="step %s %s" data-x="%s" data-y="%s" data-scale="%s" data-rotate="%s" style="%s">',
esc_attr( $fadebullets ),
$out .= '<div class="slide-content">';
$out .= do_shortcode( $content );
* Determines the position of the next slide based on the position and scaling of the previous slide.
* Array of key-value pairs.
* @type string $transition: the transition name, "up", "down", "left", or "right".
* @type float $scale: the scale of the next slide (used to determine the position of the slide after that).
* @return array with the 'x' and 'y' coordinates of the slide.
private function get_coords( $args ) {
if ( 0 === $args['scale'] ) {
$width = $this->presentation_settings['width'];
$height = $this->presentation_settings['height'];
$last = $this->presentation_settings['last'];
'scale' => $args['scale'],
'rotate' => $args['rotate'],
// All angles are measured from the vertical axis, so everything is backwards!
$diag_angle = atan2( $width, $height );
$diagonal = sqrt( pow( $width, 2 ) + pow( $height, 2 ) );
* We offset the angles by the angle formed by the diagonal so that
* we can multiply the sines directly against the diagonal length
$theta = deg2rad( $last['rotate'] ) - $diag_angle;
$phi = deg2rad( $next['rotate'] ) - $diag_angle;
// We start by displacing by the slide dimensions.
$total_horiz_disp = $width * $scale;
$total_vert_disp = $height * $scale;
* If the previous slide was rotated, we add the incremental offset from the rotation
* Namely the difference between the regular dimension (no rotation) and the component
* of the diagonal for that angle
$total_horiz_disp += ( ( ( abs( sin( $theta ) ) * $diagonal ) - $width ) / 2 ) * $scale;
$total_vert_disp += ( ( ( abs( cos( $theta ) ) * $diagonal ) - $height ) / 2 ) * $scale;
* Similarly, we check if the current slide has been rotated and add whatever additional
* offset has been added. This is so that two rotated corners don't clash with each other.
* Note: we are checking the raw angle relative to the vertical axis, NOT the diagonal angle.
if ( 0 !== $next['rotate'] % 180 ) {
$total_horiz_disp += ( abs( ( sin( $phi ) * $diagonal ) - $width ) / 2 ) * $next['scale'];
$total_vert_disp += ( abs( ( cos( $phi ) * $diagonal ) - $height ) / 2 ) * $next['scale'];
switch ( trim( $args['transition'] ) ) {
$next['x'] -= $total_horiz_disp;
$next['x'] += $total_horiz_disp;
$next['y'] -= $total_vert_disp;
$next['y'] += $total_vert_disp;
$this->presentation_settings['last'] = $next;
$GLOBALS['presentations'] = new Presentations();