/Magnific-Popup

Light and responsive lightbox script with focus on performance.

Primary LanguageJavaScriptMIT LicenseMIT

Magnific Popup Repository

This is a fork of the Magnific Popup plugin for jQuery developed by Dmitry Semenov. This fork was started to address bugs in the plugin and to make additions after development on the original plugin stopped after February 2016.

This fork contains the following additions to the last version of the original plugin released in February 2016:

  1. Full screen popup mode: passing fullScreen : true to the plugin opens the popup in full screen mode if the browser supports it.
  2. Touch support for galleries: swiping left and right when in the gallery mode on a touch-enabled device functions as click of previous and next buttons, respectively, allowing moving back and forth between gallery items.
  3. Support for youtu.be style links for iframes: the iframe addon supports links such as https://youtu.be/tPEE9ZwTmy0.
  4. fade-in animation for gallery slides: gallery slides now fade in when they appear.

Fast, light and responsive lightbox plugin, for jQuery and Zepto.js.

Optionally, install via Bower bower install magnific-popup or npm: npm install magnific-popup. Ruby gem: gem install magnific-popup-rails.

Extensions

If you created an extension for some CMS, email me and I'll add it to this list.

Location of stuff

  • Generated popup JS and CSS files are in folder dist/. (Online build tool is on documentation page).
  • Source files are in folder src/. They include Sass CSS file and js parts (edit them if you wish to submit commit).
  • Website (examples & documentation) is in folder website/.
  • Documentation page itself is in website/documentation.md (contributions to it are very welcome).

Using Magnific Popup?

If you used Magnific Popup in some interesting way, or on site of popular brand, I'd be very grateful if you email me a link to it.

Build

To compile Magnific Popup by yourself, first of make sure that you have Node.js, Grunt.js, Ruby and Jekyll installed, then:

  1. Copy repository

    git clone https://github.com/dimsemenov/Magnific-Popup.git

  2. Go inside Magnific Popup folder that you fetched and install Node dependencies

    cd Magnific-Popup && npm install

  3. Now simply run grunt to generate JS and CSS in folder dist and site in folder _site/.

    grunt

Optionally:

  • Run grunt watch to automatically rebuild script when you change files in src/ or in website/.
  • If you don't have and don't want to install Jekyll, run grunt nosite to just build JS and CSS files related to popup in dist/.

Changelog

License

Script is MIT licensed and free and will always be kept this way. But has a small restriction from me - please do not create public WordPress plugin based on it(or at least contact me before creating it), because I will make it and it'll be open source too (want to get notified?).

Created by @dimsemenov & contributors.