eCommerce Notification


Created: 06/2016

Latest update: 02/2025 – Updated version 1.2.0

By: VillaTheme
Thank you for purchasing our plugin. If you have any questions that are beyond the scope of this documentation, please feel free to request support at our Support Forum. Thanks so much!

System Requires:

Make sure that those limits to a minimum as follows in order for free-trouble while installing:

  • WordPress 5.0 or higher
  • PHP version 7.0 or higher

Download Plugin:

Go to Plugin/Add New/Upload Plugin/Choose file/ select the ecommerce-notification.zip file/click “Install Now”/click “Active plugin”.

Done! Let’s start using the plugin.

What is the eCommerce Notification?

eCommerce Notification displays all post types (posts, pages, etc) as a popup on your storefront. It’s the online equivalent of a crowded store, and it shows prospective customers that other people are accessing your pages/posts, or they are being viewed by someone.

  • Increase your site traffic by highlighting other customers that have viewed/accessed posts.
  • Compatible with all post types
  • Create a sense of urgency for visitors and expose new articles!

FEATURES

ORDER POP-UP

WordPress eCommerce Notification automatically generates the order from the given information. Then display order notification pop-up on the front-end.

  • Customer name: allow you to add a list of customer names.
  • Customer address: allow you to add to a list of customer addresses.
  • WordPress post type: the plugin can take any WordPress post type to display as “product”.
  • Select posts: select posts to display. You can select different posts from different post types to display.
  • Message: enter the message to display on pop-ups. You can use shortcodes to display the necessary information.
  • Order time: select a time period. The purchased time will be picked randomly within this period.
  • Auto-Detect address: the plugin will detect visitor addresses based on their country. And then display someone in their location just purchases recently.

 

MULTIPLE WOOCOMMERCE NOTIFICATION MESSAGES

You can add and configure as many eCommerce Notification messages as you want. Each message will be displayed on a different single pop-up.

  • Shortcodes: Use the shortcodes to configure your messages. The system will get this information from your orders or create it automatically on WooCommerce Notification
    {first_name} – Displays the customer’s first name.
    {city} – Shows the customer’s city.
    {country} – Displays the customer’s country.
    {post} – Inserts the post title.
    {post_with_link} – Inserts the post title with a clickable link.
    {time_ago} – Generates a random time within the threshold set under the "Virtual Time" option.
    {custom} – Allows you to use a custom shortcode for additional personalization.
  • States for addresses in the USA: with the shortcode for states, now you can display addresses in the USA correctly.
    Example: Someone in Chicago, Illinois, USA just purchased a Woo Ninja.
  • Compatible with WPML and Polylang:  This feature allows to display of notifications in multiple languages.

 

DESIGN

  • Text color: change the text color, post title color.
  • Background color: change the pop-up background color.
  • Post featured image: the plugin will take the post featured image to display as a main image on pop-ups.
  • Image position: select to display the post’s main image on the left side or the right side of the pop-up.
  • Image size: select the image size to display on the pop-up.
  • Pop-up position: select to display the sale notification pop-up on the top left, top right, bottom left, bottom right position.
  • Pop-up appear/disappear effect: there are 32 appear/disappear effects for you to select.
  • Custom CSS: This allows you to add your own CSS code to change the pop-up front-end design.
  • Close button: allow your visitor to hide the sale pop-up temporarily.
  • Sound: play a sound when pop-up to attractive the user’s attention.
  • Condition tags: using WordPress conditional tags to configure which page the sale pop-ups appear on.

 

TIME OPTIONS

  • Loop: the loop option will help to display multiple pop-ups on a page load.
  • Notification per page: select how many sale notifications you want to display on a page load.
  • Next time display: select the delay time between two sale notification pop-ups.
  • Delay time: select the time for the pop-up to appear after the page completes loading.
  • Display time: select the pop-up display time before it disappears.

REPORT

  • Save Logs: This helps the system stores information when visitors click on the notification. Then the admin site could statistic the number of clicks and analyze fluctuation sales. The reporting system allows statistics number of clicks by date and by-post.

AUTOMATICAL UPDATE

Authenticate purchase and auto-update the plugin from your Dashboard.

 

How to use


After installing and activating the plugin, you need to configure to show notification:

1. Turn it on:

Go to Dashboard/eCommerce Notification/General tab/Turn on plugin either on desktop or mobile of both of them

 

2. Configure your settings

 

Click “Save” to get the changes. And that should be it. You can adjust settings in other setting pages if you need, and watch the notifications show up on front end.

 

 

How does it work


 

 

General

  1. Enable: Enable/Disable eCommerce notification plugin on desktop.
  2. Mobile: Enable/Disable eCommerce notification on mobile and responsive devices.

 

 

Design

Go to Dashboard/eCommerce Notification/Design to design the notification pop-up

  1. Templates: Choose from 22 built-in templates to quickly set up your notification design.
  2. Position & effect
    1. Position: Select where the notification will appear – bottom left, bottom right, top left, or top right
    2. Show notification effect: Choose an animation effect when the notification appears
    3. Hide notification effect: Select an animation for when the notification disappears
  3. Style
    1. Message will be rounded and featured image is round instead of square – Toggle this option to round the message box and featured image instead of keeping the default square shape
    2. Custom rounded corner – If you enable the option above, set custom corner radius for the notification box as you need
    3. Background color: Choose a background color for the notification
    4. Text message color: Customize the color of the notification message text
    5. Post name text color: Define the color of the post title text
  4. Image
    1. Image Position: Adjust where the post’s featured image appears in the notification – Left or Right
    2. Gap between post image and notification’s border – Set spacing between the image and the notification border
    3. When click image, you will redirect to post single page – Toggle to enable this click behavior
    4. When click image, you will be redirected to the post’s single page on a new tab – Toggle to open the post page in a new tab when clicking the image
  5. Show Close Icon: Display an “X” icon to allow visitors to close the notification manually. If disabled, the notification remains visible until the set close time ends
    1. Icon style: Choose between “Class” or “Default” styles for the close icon
    2. Time close: Set the duration before the notification automatically disappears
    3. Close icon color: Customize the color of the close icon
    4. Close icon background: Define the background color of the close icon
  6. Custom CSS: Add your own CSS styles to further customize the notification’s appearance.
  7. Preview notification popup: View a live preview of your notification popup before applying changes.

 

 

Messages

In this section, you can customize the message displayed in the notification popup. You can use dynamic placeholders to personalize the message with real-time data.

  1. Message: You can modify the content customer sees in the notification popup, one message per line, using the placeholders below:
    • {first_name} – Displays the customer’s first name.
    • {city} – Shows the customer’s city.
    • {country} – Displays the customer’s country.
    • {post} – Inserts the post title.
    • {post_with_link} – Inserts the post title with a clickable link.
    • {time_ago} – Generates a random time within the threshold set under the “Virtual Time” option.
    • {custom} – Allows you to use a custom shortcode for additional personalization.
  2. Custom: This is the content for the {custom} placeholder
  3. Min Number: Set the minimum value for the generated custom number
  4. Max number: Set the maximum value for the generated custom number

 

 

Posts

  1. Select Post Type: Select a post type from your WordPress site to display on notifications.
  2. Select Items: Select specific items of the above post type to show on the notification.
  3. Virtual First Name: Enter your virtual customer first names. Each first virtual name on a line.
  4. Virtual Time: Setting the virtual time that how long ago a virtual behavior was processed towards a post. The purchase time will be picked randomly between this time threshold.
  5. Address: you can use the auto-detect address or make the virtual address of the customer.
    • For selecting “auto-detect address“, you need to fill in the “auth key”, which you can get at https://ipfind.co. If you do not fill in your auth key, the system will enter the default value. We recommended signing up and entering your key. The plugin will detect customers’ countries and/or cities base on their IP Addresses and display the countries and/or city addresses of the customer on the popup notification.
    • For selecting “virtual address“, you need to configure Virtual City and Country. You can enter many different cities but only one country. Then the system will automatic to show randomly virtual first names and virtual cities in the notification form.
      • Virtual cities: You can use the auto-detect address or make the virtual address of the customer.
      • Virtual Country. There are 3 options to choose from:
        • Virtual: You can enter many different cities but only one country. Then the system will automatic to show randomly virtual first names and virtual cities in the notification form.
        • WooCommerce geolocation: The address on the notification will get from WooCommerce geolocation.
        • Auto-detect: The plugin will detect customers’ countries and cities base on their IP Addresses and display customer addresses on the popup notification. You need to fill in Ipfind Auth Key, which you can get at https://ipfind.co
  6. Featured Image Size for Post: Select the image size on pop-ups.
  7. Non-Ajax: Load popup will not use ajax. Your site will be load faster. It may create caches.

 

 

Post Detail

Run single post: When the customer in the single post page, a notification will show the relevant posts (in the same categories) on notification popups

 

 

Time

  1. Loop: When turning on the loop, notifications will be repeated on a page even though visitors do not reload the page.
  2. Next time display: Time to show your notification next time.
  3. Notification per page: Quantity notifications on a page.
  4. Initial time random: Time initial delay will get random from Minimum initial delay time to Initial delay
  5. Initial delay: delay time to show a notification after loading site completely.
  6. Display time: time to show a notification

 

Sound


 

If enable sound, you can choose available audio by clicking the arrow drop-down, so that the notification will be appeared along with audio in the front-end. There are 3 sounds to select.

 

 

Assign

 

Homepage: Turn on this option to hide notifications on Homepage

Conditional Tags: to specify which pages to show a notification. You can use the Page’s ID, Title or Slug.

Important note:

To handle WP’s Conditional Tags, this plugin uses eval() which is very dangerous because it allows the execution of arbitrary PHP code. Therefore, please only fill this field with proper conditional tags which are validated and/or provided by trusted developers.

Example:
is_page(‘About’)
is_page(50)
is_page( array(‘About’, ‘Contact’) )
is_page( array(50, 75) )

Report

If you enable Save Logs, then Logs will be saved at directory placed ecommerce notification plugin: wp-content\cache\ecommerce -notification\caches\ in time.

History time: is time to save logs.

Save logs helps system stores information when visitors click on the notification. Then admin site could be the statistic of number clicks and analysis fluctuation sales. Report system allows to statistic number clicks by date or by post.

 

 

AI Engine

This settings help with automating the generation of personalized messages and virtual details like customers’ names and cities. Scroll down below to read more of each option and how to set up.

  1. AI Type: The type of AI engine for generating details. Different AI types may provide varying levels of sophistication, customization, or regional accuracy in generated data. At the moment, we support:
  2. Min characters:  Set the minimum length for AI-generated messages
  3. Max characters: Define the maximum length of the generated text
  4. Writing style: Choose a preferred writing style for AI-generated messages, such as casual, formal, promotional, persuasive, or descriptive
  5. Writing tone: Adjust the tone to match your brand’s messaging, such as neutral, friendly, professional, or enthusiastic.

 

Settings for Gemini

  1. API key: To use the Gemini API, you’ll need an API key. If you don’t already have one, create a key in Google AI Studio. Follow these steps to get Gemini API key
    • Go to https://ai.google.dev/gemini-api
    • Select “Get an API key from Google AI Studio
    • Click “Create API key
    • Then, configure your key. And copy the key and paste it to this field
  2. API version: Specify the version of the AI service’s API to be used. For more details of Gemini API version, please see API versions explained.
  3. API model list: Choose from a list of AI models available associated with the selected version. You can check this article for more details of Gemini models
  4.  “Message purchased” prompt: Enter the command that tells the AI how to generate personalized purchase messages
    E.g. Write 1 short different social proof notifications for purchase purpose. Must be between {MIN_CHARACTERS} and {MAX_CHARACTERS} characters. Style: {WRITING_STYLE}. Tone: {WRITING_TONE}.
  5.  “Virtual First Name” prompt: Specify the prompt to generate virtual customer first names
  6.  “Virtual City” prompt: Set the prompt to generate virtual customer cities

 

Settings for OpenAI

  1. API key: Follow these steps to get API key
    • Login and access API Keys page of OpenAI: https://platform.openai.com/settings/organization/api-keys
    • Create and copy the key
  2. API model list: Choose from a list of AI models available associated with the selected version. You can check this article for more details of Gemini models
  3.  “Message purchased” prompt: Enter the command that tells the AI how to generate personalized purchase messages
    E.g. Write 1 short different social proof notifications for purchase purpose. Must be between {MIN_CHARACTERS} and {MAX_CHARACTERS} characters. Style: {WRITING_STYLE}. Tone: {WRITING_TONE}.
  4.  “Virtual First Name” prompt: Specify the prompt to generate virtual customer first names
  5.  “Virtual City” prompt: Set the prompt to generate virtual customer cities

 

Generate content using AI Engine

  • After properly configuring these settings, go back to Messages and Posts setting pages to generate content. You will see a blue “AI Generator” button. Simply click on it.
    For example, on Messages page: Click “AI Generator” in to get content in generated
  • If the “Message Purchased Prompt” in AI Engine settings returns multiple results in [2], you can choose which message to add to the Message input field. If only one message is generated, it will be added to that text area automatically.

 

 

 

Update

Enter your Envato purchase code to use the auto-update feature.

 

COMPATIBILITY


Plugin Author
WPML OnTheGoSystems
Polylang WP SYNTEX
Notification for WooCommerce villatheme

Extra Information


Thank you for your attention!

If you have any question, please create a topic at our FORUM, we will support within 24 hours.