Code Monkey home page Code Monkey logo

corner-popup's Introduction

Corner Popup v1.31

Fully customizable pop-up box created to display all types of messages in corner of your browser.

Website: https://espritdesign.pl/corner-popup
Demo: https://espritdesign.pl/corner-popup/demo

More about Corner Popup

What is Corner Popup? It's a simple pop-up component that can be used on almost all modern websites. It simply displays small pop-up box in corner of browser. Corner Popup is fully configurable and you can change many parameters - position, window color, content inside etc. Corner Popup is easy to use and you don't need any programming skills. As a component Corner Popup needs only jQuery to work. It is fully responsive without using any framework.

How to use

Using Corner Popup is very simple. As the first step, add jQuery and Corner Popup files for the project (remember to add appropriate files to folders):

<link rel="stylesheet" href="css/corner-popup.min.css">
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script src="js/corner-popup.min.js"></script>

In step 2 call script from your website code:

<script>
$.fn.cornerpopup({
});
</script>

In step 3 you can (but it's not necessary) set some options in previously added code:

<script>
$.fn.cornerpopup({
variant: 1,
slide: 1
});
</script>

All available options with description:

Option Default Description
active true Makes popup enabled or disabled. If it is set to 1 popup will show. If set to 0 it's disabled.
displayOnce false If this option is set to 1, the popup will be displayed only once (which is stored in browser memory).
variant 1 Using this option you can set a variant of the popup window. There are 10 variants which could be used for different purposes - for example variant 2 is an option used for cookies information - it even creates and saves cookie for you.
slide false If this option is set to 1 standard method of showing a popup (fade) will change to slide.
slideTop false This option could be used only if "slide" is set to 1. It makes slide always work from bottom to top.
delay 0 This option sets delay to popup. It will appear after the amount of time you set as parameter (in milliseconds).
timeOut 0 This option sets the timeout to popup, so it will appear and disappear after the amount of time you set as parameter. If you set for example 500 it will disappear after 500ms.
closeBtn true Sets close button visibility - if it is set to 0 close button will not show in any variant of the popup.
shadow true Sets popup shadow visibility - if it is set to 0 shadow won't be visible in any variant of the popup.
link1 You can change the link that is used in variant 1 of popup. Just type a new address as first parameter and target as second - e.g. link1: "https://espritdesign.pl, _blank".
link2 # You can change the link that is used in most of popup variants. Just type a new address as first parameter and target as second - e.g. link2: "https://espritdesign.pl, _blank".
popupImg You can change the image used in popup variant 1. Type your own link to image here.
cookieImg You can change the image used in popup variant 2 (cookies). Type your own link to image here.
messageImg You can change the image used in popup variant 3 (message). Type your own link to image here.
header In this option you can change header used in some of popup variants. You can use html tags here.
text1 In this 2 options you can change text used in popup variants - text1 is for cookie message. You can use html tags here.
button1, button2, button3 In this 3 options you can change label used in the buttons. "button2" is used in cookies popup.
content You can place in this option text (including html tags) which is displayed in variant nr.10 of popup - this variant is made to show your own content.
loadContent false This option loads data from another file (e.g. html file with prepared content). Just write the file address as parameter.
width 390px This option is used to change the popup width. Use here css units.
font This option is used to change the font used in popup elements. Use here css code - e.g. "'Open Sans', 'Halvetica', sans-serif".
colors #543189 This option changes color of primary elements - close button icon, headers, buttons.
bgColor #fff This option changes background color of popup.
borderColor #efefef This option changes border color of popup.
textColor #181818 This option changes text color in popup.
iconColor #543189 This option changes close button color.
btnColor #543189 This option changes color of buttons in popup.
btnTextColor #fff This option changes color of text in buttons.
corners 0px This option is used to change popup corner radius.
position right This option is used to change position of the popup. You can change position to left, center or right.
padding 0 This option is used to change padding inside of the popup. You can change it to any value.
escClose false Closes pop-up window after Escape key is pressed. This option works if it is set to 1.
topCorner false Makes the pop-up appear at the top of the browser window. Works if it is set to 1.
stickToBottom false Removes the pop-up margin and makes it stick to the edge of the browser. Works if it is set to 1.

Corner Popup provides public methods (e.g. usage):

$.fn.cornerpopup.popupClose();
Method Description
popupClose Closes pop-up window whenever you want.
popupHide Hides pop-up window (it can be restored at any time).
popupShow Shows hidden pop-up window.

You can add delay for each method. Just call the method like this: $.fn.cornerpopup.popupShow(100); - where 100 is the time in milliseconds.

Corner Popup events:

<script>
$.fn.cornerpopup({
variant: 1,
beforePopup: function() {
// Your code here
}
</script>
Event Description
beforePopup Your code will work before the popup window appears.
afterPopup Your code will work after closing the pop-up window.
onBtnClick Your code will work after pressing the popup button.
onCloseBtnClick Your code will work after pressing close button.

License

Corner Popup is licensed under the Creative Commons Attribution 4.0 International License: https://creativecommons.org/licenses/by/4.0

Author

Łukasz Brzostek

Have a question about usage? Found a bug?
Feel free to write a message to me: [email protected]

corner-popup's People

Contributors

lukasz-brzostek avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

corner-popup's Issues

Popup CTA links do not work on Safari

Describe the bug
The CTAs on the popup on Safari do not work after clicking the button. I tried using your examples as well with no luck: https://espritdesign.pl/corner-popup/demo/

To Reproduce
Steps to reproduce the behavior:

  1. https://espritdesign.pl/corner-popup/demo/ (your demo)
  2. Select Standard popup
  3. Click on More button
  4. A user doesn't get redirected to a new page

Expected behavior
It should redirect to the link specified in JS options 'link1|link2 etc'

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

  • OS: Mac (both mobile and desktop)
  • Browser: Safari
  • Version: 14

Remember close action

Hello

The popup is being fired on each page load.
Is there anyway for the pop to remember to close action ? something like a cookie ?
I am using variant 10.

Thanks

Additional Instructions

Thank you for this project!

I'm not much of a dev and need some help:

Using the following in the script:
link1: https://example.com

How can I make it open to a new tab?

I know for the most part, editing the content is just basic css work but a few more examples would be super helpful.

Also, using variant 10 for example:
'Your own html here' - Where do I put my html and how should it be formatted in the script?

edit: I used variant 10 and the 'content:' tag and put my html into that.

Thanks

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.