Title: SitePoint Random Hello Bar Author: sitepointdevs Published: January 21, 2016 Last modified: January 22, 2016 --- Search plugins ![](https://ps.w.org/sp-random-hello-bar/assets/banner-772x250.png?rev=1333316) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/sp-random-hello-bar/assets/icon-256x256.png?rev=1333316) # SitePoint Random Hello Bar By [sitepointdevs](https://profiles.wordpress.org/sitepointdevs/) [Download](https://downloads.wordpress.org/plugin/sp-random-hello-bar.1.0.1.zip) * [Details](https://test.wordpress.org/plugins/sp-random-hello-bar/#description) * [Reviews](https://test.wordpress.org/plugins/sp-random-hello-bar/#reviews) * [Installation](https://test.wordpress.org/plugins/sp-random-hello-bar/#installation) * [Development](https://test.wordpress.org/plugins/sp-random-hello-bar/#developers) [Support](https://wordpress.org/support/plugin/sp-random-hello-bar/) ## Description As descibed in-depth on [SitePoint](http://www.sitepoint.com/sitepoint-random-hello-bar-wordpress-plugin/) a hello bar is a thin bar of content that slides into view once the user scrolls past a set point on a page. The message content is up to you, but is ideal for advertising, product annoncements or other messages. This plugin provides an admin interface to create multiple hello bar messages that can then be randomly displayed on user facing pages. By setting weightings for each message you can determine how often each is displayed. On each page load a message is randomly selected (respecting the weightings given). A random number is generated client side before fetching the message content to ensure it is compatible with caching services such as W3 Total Cache. All the required javascript and css is included in the plugin and can be set to enqueue via settings. Alternatively you can roll your own. To help with that the core javascript has been extracted into the [sp-hello-bar](https://www.npmjs.com/package/sp-hello-bar) npm module for you to include in your own scripts. ## Screenshots * [[ * **Hello Bar in use** – An example hello bar being displayed on the Twenty Fifteen theme. * [[ * **SP Random Hello Bar Submenu** * [[ * **Settings** – Quickly enable the hello bar feature and chose what js/css to enqueue. * [[ * **Content** – Add as many hello bars as you wish. ## Installation 1. Upload the entire `/sp-random-hello-bar/` folder to the `/wp-content/plugins/` directory. 2. Activate the plugin through the ‘Plugins’ menu in WordPress. 3. Navigate to the **SP Random Hello Bar** section of the _Settings_ menu. At `example. com` this page would be found at `http://example.com/wp-admin/options-general.php? page=sp-random-hello-bar`. 4. Enable the hello bar to display in pages. 5. Select which javascript, if any, you would like to enqueue. 6. Select if you would like to enqueue basic css styles fror the hello bar. 7. Enter content for one or more hello bars and set a weighting. ## FAQ Can I use the javascript module without npm? Sure. The plugin contains the SpHelloBar source as an ES6 Module at `src/js/SpHelloBar. js` and as a common.js module at `lib/SpHelloBar.js`. Does the javascript require other libraries such as jQuery to function? The SpHelloBar module does not have any external dependencies but it would then be up to you to provide a throttle function and to load the hello bar content into the page (usually via ajax). However the Basic and Basic with storage scripts assume that jquery and underscore have been enqueued. Those two libraries are enqueued in the default setup of WordPress unless you have dequeued them. Can I customise the content? Go for it. The basic scripts assume the default css class names are being used but the only one that is required is `.SpHelloBar`. The javascript has been designed to be as flexible as possible so see the [docs](https://github.com/sitepoint/sp-random-hello-bar#constructor) for all the options that can be overridden when writing your own script. How did you build something so wonderful? I’m glad you asked. You can read about how it was put together on [SitePoint](http://www.sitepoint.com/sitepoint-random-hello-bar-wordpress-plugin/). ## Reviews There are no reviews for this plugin. ## Contributors & Developers “SitePoint Random Hello Bar” is open source software. The following people have contributed to this plugin. Contributors * [ sitepointdevs ](https://profiles.wordpress.org/sitepointdevs/) [Translate “SitePoint Random Hello Bar” into your language.](https://translate.wordpress.org/projects/wp-plugins/sp-random-hello-bar) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/sp-random-hello-bar/), check out the [SVN repository](https://plugins.svn.wordpress.org/sp-random-hello-bar/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/sp-random-hello-bar/) by [RSS](https://plugins.trac.wordpress.org/log/sp-random-hello-bar/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.0.1 * Submitted to WordPress for approval #### 0.0.2 * Added assets #### 1.0.0 * Ready for use ## Meta * Version **1.0.1** * Last updated **10 years ago** * Active installations **10+** * WordPress version ** 3.0 or higher ** * Tested up to **4.3.34** * Language * [English (US)](https://wordpress.org/plugins/sp-random-hello-bar/) * Tags * [ads](https://test.wordpress.org/plugins/tags/ads/)[advertising](https://test.wordpress.org/plugins/tags/advertising/) [marketing](https://test.wordpress.org/plugins/tags/marketing/)[products](https://test.wordpress.org/plugins/tags/products/) * [Advanced View](https://test.wordpress.org/plugins/sp-random-hello-bar/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/sp-random-hello-bar/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/sp-random-hello-bar/reviews/) ## Contributors * [ sitepointdevs ](https://profiles.wordpress.org/sitepointdevs/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/sp-random-hello-bar/)