Power Widgets documentation

  1. Installing Power Widgets in WordPress
  2. Recovering Lost License Key and Lost Password
  3. Getting Started
  4. Areas Covered By Power Widgets and Internal Logic
  5. Working with Power Widgets Basic Table and From Inside a Given Page or Post
  6. Save Time – Work with Patterns
  7. Changing Themes – Theme Replacements Importer
  8. Uninstalling Power Widgets
  9. Troubleshooting

Installing Power Widgets

  1. Go to “My Account” on our website, using your username and password.
  2. You will a list of your recent orders (or single order) along with current status. Please note that in order to be able to download the order, the status should be Complete. In case the status is marked as Processing – it means that payment is not complete.
  3. Clicking the View button, or the order number will take you to the order details, where you can download your product (see screenshots below).
  4. Upload Power Widgets via Plugins/Add New/Upload. You may also upload it to server using ftp software – Filezilla is a free and robust option – and unpack it on your server.
  5. Go to Plugins and activate the plugin.
  6. You will now see “Power Widgets” on your WordPress navigation menu.
  7. Insert the license key you received upon purchase into the text-box at the top of the Getting Started page, add the email you have signed up to SuperPlugin when opening your account and click Activate. While obtaining your license key, make sure you don’t copy any spaces before or after the license key. Once activated, you will be able to receive update notifications directly via WordPress dashboard.
  8. Power Widgets will recognize and add any page, post or category to the appropriate table dynamically.
recent orders view order

license activation - power widgets documentation

Recovering Lost License Key and Lost Password

  1. Recovering your lost license key is easy: hover Account on the left top corner of our website, and choose “Lost License”. You will be redirected to a page prompting you to enter the email you signed up with. Your lost license will be emailed to you shortly after you submit the form.
  2. In case you need to reset password, click the “Lost Password” link and you will be prompted to enter either your email or username. Recovery instructions will be emailed to you shortly after.
  3. Please note that our server verifies the times you license has been activated against your license terms. Once you hit the limit, no further activation will be possible. You may upgrade your license at any time.
  4. If you fail to recover license or passwords, please contact us and we will be glad to help.
license recovery your license key

Getting Started

  1. Power Widgets for WordPress is the easiest and most comprehensive way to manage your widget areas throughout your pages and posts.
  2. Note: Power Widgets support RTL themes – simply click the Adjust Direction button if you use such a theme and fail to see the table properly.
  3. Your theme comes with predefined widget areas (often called “sidebars”), ready for receiving various widgets using WordPress default drag and drop interface (Appearance/Widgets).
  4. Under Power Widgets menu, navigate to “Manage Widget Areas”. Create new widget areas as required. Watch this video to see how it is done.
  5. Use short descriptive names for any widget area you create, and a description to appear inside the widget area once opened, in Widgets view.
  6. You may add or remove any custom widget area at any time. However, if you plan your work and assuming you know what your site’s hierarchy is should look like, you can make a list of all your custom widget areas with the desired content.
  7. Create your custom widget areas in the fashion described above and move on.
  8. Now for the fun part: Click Manage Widget Areas in Pages and start filling the table according to your list of desired custom widget areas.
  9. For example: suppose you want your Contact Us page to have unique text widget in your primary widget area, and some unique graphics in your top widget area, you should do the following:
    • Create a Contact Us page, if you haven’t done so
    • Create a unique widget area for both areas, one for the primary widget area and another to be used in the top widget area
    • Go to Manage Widget Areas in Pages, find Contact Us page in the left row (of course, the page should be created first), and then find the cell in conjunction with the column of Primary Widget area – click it and you will have a drop-down menu with the selection of all your custom widget areas available for you. Select the appropriate custom widget area and carry on to your next selection.
    • Click Save once you done attaching unique widget areas to pages/posts.
    • Go to Appearance/Widgets and there you will see your custom widget areas available for you to work with. Simply drag and drop the widgets of your choice and you’re done!
  10. Go to the page and check the result. You can watch this video to see how it is done on pages, and that one to see how it is done on posts.
  11. You may also manage widget areas in category pages. Navigate to “Manage Widget Areas in Categories” and set custom widget areas as required.
  12. Posts are handled similarly to pages via “Manage Widget Areas in Posts”.
Ilegal name alert manage widgets in pages

Areas Covered By Power Widgets and Internal Logic

  1. Power Widgets covers the following areas in your site:
    • Any default sidebar on your theme may be replaced with a custom sidebar
    • Pages and posts
    • Categories and Tags – you will be able to customize the archive page, namely the front page of a given category. For example: www.mydomain.com/category/tomato – any customization made to this category will be visible in the homepage of the category.
    • Page templates: default pages WordPress comes with out of the box: Blog page – for blog’s front page; 404 page – for not found page; Search results  and Date archive page. We intend to add Author page in a matter of a few weeks.
    • Patterns – will be explained in the following chapter
    • Theme Replacements Importer – shortened as “Importer” in Power Widgets menu, will be explained hereafter.
  2. If you need to customize a certain blog post, you should customize it individually. Although we could assign the category to include each and every post it contains, we wanted to avoid conflicting categories overriding one another and complex operation, simply because bloggers often want to categorize a single post to more than one category. In any event, having patterns available for you, this can be done in no time.

Working with Power Widgets Basic Table and From Inside a Given Page or Post

  1. By default, all posts and pages name are set alphabetically and are linked to the actual page. This may come handy if you have pages or posts with the same name in different locations in your site’s hierarchy.
  2. The initial default view is set to show 10 pages at once. You may change this by clicking on the drop down box on the bottom left of the table and select a different value – up to 50 pages. You may use the search box in order to find a certain post or a page. You will then have a scroll bar on the left side of the table. Alternatively, you can navigate with the arrows to the next page.
  3. The entire work with the table is done without having to refresh the page, making it super fast. Once you are done changing one or more settings, simply click the Save button and you are done.
  4. The best way to go when you are developing a new website whereby you have your plans in front of you is to work from the central table and move from one part to another. There are other use cases that working from inside the page will be faster and easier. This may come to mind especially when you are working on an already running site with most of the settings (such as custom sidebars and patterns) available for you to use. In that case, you may apply changes to a specific page or post from within the page/post. Scroll down below the content zone and there you will find the relevant table with all the functionality that applies to the given page or post. Once done, click Save on the Power Widgets interface and the page will automatically scroll upward. Don’t forget to click update and check for the results.
table-controls-explained

Save Time – Work with Patterns

  1. In order to speed up the process, you may work with Patterns: set patterns to be apply on various pages and posts based on the widgets combinations you’d like to have on certain parts of your websites.
  2. For example: if you wish to change both top and primary sidebar for “Tomato” pages across your site, simple create a pattern with these settings. Then, you may use this pattern anywhere on your site and save the time you’d otherwise do the same customization for both widget areas on each and every page.
  3. Simply put, patterns let you create a set of custom sidebars, name it and have it available for use in any page, post, category or page template on your site. Let’s say that you have a set of products in your catalog which you want them to have the same top custom sidebar, same primary custom sidebar and the same bottom custom sidebar with the following population:
    • Top custom sidebar: set custom graphics
    • Primary custom sidebar: custom menu and a unique call to action
    • Bottom custom sidebar: related products/related content items.
  4. Normally, regardless of the plugin you’d use for the task, you’d have to go page by page and assign these three custom sidebars separately and repeatedly. With Patterns, all you have to do is set it once, save it and it ready to be use with a single, consistent action time and again across your site.
  5. The best part yet: suppose you are not ready with the graphics for your top custom sidebar – no worries. Once you’re ready, update the pattern and all the pages related will include the change – all you have to do is now populate this one custom sidebar with the appropriate widget and you’re done!
  6. Controls: use New to create a new pattern – name it, assign custom replacements for the sidebars you wish; use Save to save it. If you wish to delete, simply stand with your mouth inside the name box and click delete. You will be prompted with a dialog box, click cancel if you wish to do nothing or OK if you want to complete the deletion.
  7. Watch this video to see how patterns are used and controlled.
patterns

Changing Themes – Theme Replacements Importer

  1. As of the coming version, Power Widgets will allow you to import your customization settings done with the plugin in your current theme and have them available on your new theme.
  2. We will update this chapter as soon as the version is ready.
  3. In the meanwhile, you may read about it here.
theme replacements importer

Uninstalling Power Widgets

  1. Uninstalling Power Widgets deletes all related settings – custom widget areas and their content.
  2. You will be warned before deleting to avoid accidental deletion.
  3. Only administrators are authorized to uninstall Power Widgets, so choose your users’ privileges wisely.
  4. To uninstall Power Widgets, go to plugins, deactivate it and then delete. You will be warned before deletion is executed, click Yes and the plugin with all corresponding database tables will be deleted.

Troubleshooting

  1. Make sure you work with the latest version of WordPress. If you don’t, you should upgrade immediately for security and compatibility reasons.
  2. Same goes for the plugin – make sure you work with the latest version.
  3. Disable all other plugins and see what happens. Assuming Power Widgets works properly now, try to activate one plugin at a time and try again in order to identify potential conflicts.
  4. Try working with a default theme like Twenty Ten or Twenty Twelve. If it works properly with such default theme, it may suggest that the theme you work with is incompatible with Power Widgets. While we work to make it compatible with many popular theme frameworks such as Artisteer and WooThemes, it is impossible to have 100% compatible with any theme that is out there. Check Theme Compatibility page and blog’s category related posts and see if Power Widgets current support list includes your theme. Contact us and let us know which theme you are using and we will let you know if and when we intend to support your theme.
  5. Make sure you don’t have any other compatible plugin that suppose to look after your widget areas/sidebars. If you do, deactivate and uninstall it completely before installing Power Widgets.
  6. Submit a ticket, we’re here to help.
  7. Power Widgets documentation will continue to evolve as we add more functionality to the plugin.
Power Widgets documentation was recently updated at 23 October, 2013