WordPress.org

Slovensko

Get WordPress
WordPress.org

Plugin Directory

Webside Popup Creator

Webside Popup Creator

Od Andaç Güven
Stiahnuť

Popis

Webside Popup Creator is a simple yet flexible plugin designed to help you create and manage popups on your WordPress website without hassle. Whether you want to display promotional messages, capture leads with a simple form, or show important notices, this plugin provides the essential tools in a lightweight package.

Built with simplicity and performance in mind, Webside Popup Creator avoids unnecessary bloat, focusing on core features that work effectively. This plugin is licensed under the GPLv2 (or later), ensuring compatibility with WordPress standards.

Key Features:

  • Easy Configuration: A straightforward settings page integrated into the WordPress admin area (Settings > Webside Popup). Also includes a quick „Settings“ link on the main Plugins page.
  • Multiple Trigger Options:
    • Time Delay: Show the popup after a specific number of seconds.
    • Scroll Percentage: Trigger the popup when a user scrolls down a certain percentage of the page.
  • Flexible Content Types:
    • HTML Content: Use the standard WordPress editor (or simple textarea) to add any HTML, including text, links, basic forms, and shortcodes.
    • Image Content: Easily upload or select an image from the media library to display as the popup (uses wp_get_attachment_image for better theme compatibility). Optionally make the image clickable by adding a link URL.
  • Targeting Controls:
    • Display on the entire site.
    • Display everywhere except the homepage.
    • Display only on the homepage.
    • Display only on single blog posts.
    • Display only on specific URLs or URL paths (enter one per line).
  • Appearance Customization:
    • Adjust the background overlay opacity.
    • Set a custom border-radius for the popup container corners.
  • Closing Options:
    • Standard ‚X‘ close button.
    • Optionally allow users to close the popup by clicking on the background overlay.
  • Cookie Control: Prevent the popup from showing repeatedly to the same user by setting a cookie. You can define the cookie expiration duration in hours or days.
  • Responsive Design: Popups are designed to display correctly on different screen sizes (desktop, tablet, mobile).
  • Lightweight: Minimal code to ensure fast loading times.
  • GPLv2 Compatible: Licensed under GPLv2 or later, aligning with WordPress guidelines.
  • Standards Compliant: Uses WordPress enqueue functions (wp_enqueue_script, wp_enqueue_style, wp_localize_script, wp_add_inline_style) for loading assets and unique function prefixes (webspop_).

Configuration

After activating the plugin:

  1. Navigate to Settings > Webside Popup in your WordPress admin menu (or click the „Settings“ link directly from the Plugins page).
  2. Enable Popup: Check this box to activate the popup functionality.
  3. Where to Display: Choose where the popup should appear (Entire Site, Everywhere Except Homepage, Homepage Only, Posts Only, Specific URLs).
    • If you select „Specific URLs“, enter the target URLs or paths (one per line) in the text area below. This field will appear faded if „Specific URLs“ is not selected, but it’s always present. Examples: /about-us, /products/, https://yourdomain.com/contact. The popup will appear if the current page URL contains any of the provided strings.
  4. How to Trigger: Select whether the popup should appear after a time delay or after the user scrolls down the page.
    • Configure the Delay (Seconds) or Scroll Percentage (%) accordingly.
  5. Content Type: Choose between „HTML Code“ or „Image“.
    • HTML Code: Enter your desired HTML content in the text area. You can include text, links, images, and basic form elements.
    • Image: Click „Select / Upload Image“ to choose an image from your media library. Optionally, enter a URL in the „Image Link URL“ field to make the image clickable (opens in a new tab). The preview will update after saving.
  6. Appearance:
    • Adjust the Overlay Opacity (0 = fully transparent, 1 = fully opaque).
    • Set the Border Radius in pixels for rounded corners.
  7. Closing: Decide if users should be able to close the popup by clicking the Overlay.
  8. Optional Settings:
    • Prevent Showing Again (Cookie): Check this box to enable cookie-based frequency capping.
    • Cookie Expiration: Set the duration (e.g., 24) and unit (Hours or Days) for how long the popup should stay hidden after being closed.
  9. Click Save Settings.

Your popup should now be active based on your configuration!

Obrázky

  • The main settings page in the WordPress admin area. (screenshot-1.png)
  • Example of a popup triggered by time delay with HTML content. (screenshot-2.png)

Inštalácia

  1. Upload Method:

    • Download the webside-popup-creator.zip file (containing the main PHP file, readme.txt, and admin/public asset folders).
    • Log in to your WordPress admin panel.
    • Navigate to Plugins > Add New Plugin.
    • Click the Upload Plugin button at the top.
    • Click Choose File and select the webside-popup-creator.zip file you downloaded.
    • Click Install Now.
    • Once installed, click Activate Plugin.

  2. Manual Method (FTP):

    • Download the webside-popup-creator.zip file and unzip it. You should have a folder named webside-popup-creator containing the main PHP file, readme.txt, and admin & public folders.
    • Upload the entire webside-popup-creator folder to the /wp-content/plugins/ directory on your server using an FTP client.
    • Log in to your WordPress admin panel.
    • Navigate to Plugins > Installed Plugins.
    • Find „Webside Popup Creator“ in the list and click Activate.

Časté otázky

How do I create my first popup?

Install and activate the plugin. Then go to Settings > Webside Popup (or use the „Settings“ link on the Plugins page). Configure the options like trigger, content, and targeting, make sure to check the „Enable Popup?“ box, and click „Save Settings“.

Can I add a contact form or email signup form?

Yes. Select „HTML Code“ as the Content Type and paste your form’s HTML code into the „HTML Content“ text area. Note that this plugin only displays the form; it does not handle form submissions itself. Your form’s action attribute should point to the service or script that processes the submission.

How does the ‚Specific URLs‘ targeting work?

You enter URLs or parts of URLs, one on each line. For example:
* /services/ will match yourdomain.com/services/ and yourdomain.com/services/web-design/.
* yourdomain.com/specific-page will match only that exact page.
* /category/news/ will match all posts in the ‚news‘ category archive and posts within that category if your permalinks include the category.
The plugin checks if the current page’s full URL contains any of the strings you entered.

What does ‚Everywhere Except Homepage‘ mean?

This option will display the popup on every page of your site except for your main homepage (the page designated as your front page or your main blog posts index).

How can I stop the popup from annoying repeat visitors?

Go to the „Optional Settings“ section. Check the box for „Prevent Showing Again (Cookie)“. Then, set the „Cookie Expiration“ duration (e.g., 7) and select the unit (Hours or Days). After a user closes the popup, it won’t appear again for them for the specified duration.

Is the popup responsive?

Yes, the plugin includes basic CSS to ensure the popup adapts to different screen sizes and avoids breaking layouts on mobile devices. The image display also uses standard WordPress functions for better theme compatibility.

What is the license for this plugin?

This plugin is licensed under the GNU General Public License v2 or later, which is compatible with WordPress.

Recenzie

Pre tento plugin nie sú žiadne recenzie.

Prispievatelia a vývojári

“Webside Popup Creator” je softvér s otvoreným zdrojovým kódom. Do tohto pluginu prispeli nasledujúci ľudia.

Prispievatelia

Preložiť „Webside Popup Creator“ do vašho jazyka.

Máte záujem o vývoj?

Prehľadávajte zdrojový kód, preskúmajte SVN repozitár, alebo sa prihláste na odber vývojárskeho logu cez RSS.

Zoznam zmien

1.2.5

  • Reinstated activation hook (register_activation_hook) safely to handle default options, preventing potential „headers already sent“ errors during activation.
  • Ensured default settings are applied correctly if no options exist yet.
  • Updated Stable Tag and plugin version to 1.2.5.

1.2.4

  • Reinstated activation hook (register_activation_hook) with a safe activation function (webspop_activate) that only adds default options if they don’t exist, preventing potential „headers already sent“ errors. (Incorrect implementation, fixed in 1.2.5)
  • Ensured frontend HTML output is strictly passed through wp_kses_post() before echoing to satisfy stricter Plugin Check requirements.
  • Updated Stable Tag and plugin version to 1.2.4.

1.2.3

  • Removed plugin activation hook (register_activation_hook) to prevent potential „headers already sent“ errors. Default settings are now handled via webspop_get_setting(). (Reverted in 1.2.4)
  • Ensured frontend HTML output is passed through wp_kses_post() before echoing to satisfy stricter Plugin Check requirements, even if already sanitized. (Improved in 1.2.4)
  • Updated Stable Tag and plugin version to 1.2.3.

1.2.2

  • Removed final PHP closing tag ?> to prevent potential „headers already sent“ errors.
  • Updated Stable Tag and plugin version to 1.2.2.

1.2.1

  • Refactored asset loading to use standard WordPress enqueue functions (wp_enqueue_script, wp_enqueue_style, wp_localize_script, wp_add_inline_style) instead of inline scripts/styles.
  • Moved admin CSS/JS and public CSS/JS into separate files within admin and public subdirectories.
  • Replaced short function prefix wsp_ with longer, more unique prefix webspop_. Updated option names and CSS IDs accordingly.
  • Removed load_plugin_textdomain() call as it’s handled by WordPress.org for hosted plugins.
  • Ensured frontend HTML output is escaped using wp_kses_post where appropriate. (Improved in 1.2.3)
  • Updated Stable Tag and plugin version to 1.2.1.

1.2.0

  • Removed instant JavaScript image preview update in admin settings to resolve Plugin Check warnings. Preview now updates after saving.
  • Updated Stable Tag and plugin version to 1.2.0.

1.1.8

  • Updated admin image preview to use wp_get_attachment_image().
  • Changed visibility logic for „Target Specific URLs“ field to always show but appear disabled when inactive.
  • Ignored unavoidable NonEnqueuedImage warning for admin preview image using phpcs:ignore. (Removed ignore in 1.2.0)
  • Updated Stable Tag and plugin version to 1.1.8.

1.1.7

  • Fixed Text Domain mismatch errors by setting Text Domain to webside-popup-creator in plugin header and updating all translation function calls.
  • Corrected escaping for translation functions (__, _e) to use esc_html__, esc_attr__, esc_html_e, esc_attr_e where appropriate for improved security.
  • Removed Domain Path header as language files are not included in this version.
  • Updated Tested up to in readme.txt to 6.8.
  • Reduced tags in readme.txt to 5.
  • Updated image handling to save Attachment ID instead of URL.
  • Use wp_get_attachment_image() for frontend image display for better theme compatibility and standards compliance.
  • Ignored NonEnqueuedImage warning for admin preview image using phpcs:ignore. (Incorrectly applied, fixed in 1.1.8)
  • Updated Stable Tag and plugin version to 1.1.7.
  • Shortened short description in readme.txt to comply with character limits.

1.1.6

  • Fixed Text Domain mismatch errors by setting Text Domain to website-popup in plugin header. (Incorrect approach, fixed in 1.1.7)
  • Corrected escaping for translation functions (__, _e) to use esc_html__, esc_attr__, esc_html_e, esc_attr_e where appropriate for improved security.
  • Removed Domain Path header as language files are not included in this version.
  • Updated Stable Tag to 1.1.6.

1.1.5

  • Updated License to GPLv2 or later to comply with WordPress.org guidelines.
  • Updated Stable Tag to 1.1.5.

1.1.4

  • Added „Settings“ link directly on the main WordPress Plugins page for easier access.
  • Added new display target option: „Everywhere Except Homepage“.

1.1.3

  • Updated plugin header information (License to Proprietary – reverted in 1.1.5).
  • Corrected admin menu and page titles to „Webside Popup“.
  • Updated Plugin URI to webside.com.tr.
  • Fixed CSS for close button (‚x‘) alignment using Flexbox.

1.1.2

  • Changed plugin name to „Webside Popup Creator“.
  • Updated Author and Author URI.
  • Fixed close button alignment issue (centering ‚x‘).

1.1.1

  • Updated plugin header information (Name, Author, URI).
  • Fixed close button positioning CSS.

1.1.0

  • Added „Target Specific URLs“ display option.
  • Added „Hours“ option for Cookie Expiration unit.
  • Added „Image Link URL“ option for clickable image popups.
  • Added „Border Radius“ setting for popup container.
  • Improved CSS for image content to prevent scrollbars.
  • Changed all text and code comments to English.
  • Refactored function prefixes from wbp_ to wsp_.
  • Updated text domain to website-popup.

1.0.0

  • Initial release.

Meta

Hodnotenia

No reviews have been submitted yet.

Pridať moju recenziu

See all reviews

Prispievatelia

Podpora

Máte čo povedať? Potrebujete pomoc?

Zobraziť fórum podpory

Podporiť

Chceli by ste podporiť pokrok tohto pluginu?

Prispieť na plugin