Importing Demo Content

If you’d like to import the posts and pages and images from the Utility Pro Demo site, you can do that!

Finding The XML File

First you need to download the file.  It has an XML extension and you download it here.

How To Import The Demo File

Screen shot of Tools - Import in the Dashboard

  1. Go to Tools => Import while logged in to your Admin Dashboard.
  2. Choose “WordPress” from the list.
  3. Upload the file you downloaded above.
  4. You will be asked to map the authors in the export file to users on the blog. For each author, you may choose to map to an existing user on the blog or to create a new user.
  5. You will then have the choice to import attachments, so click on the “Download and import file attachments” box.
  6. WordPress will import each of the posts, comments, and categories into your blog.

The purpose of the demo content is to setup your homepage widgets and watch the theme come together like the demo site.  In addition, if you look a little closer at the post and page content, you will see a wealth of information.  They are basically short tutorials on how to use the built-in theme styling to achieve a variety of looks.

How to Manually Update Utility Pro

For Personal and Professional (Developer’s Edition)

Yipee!  We’ve just announced a new update for Utility Pro!  But the question is, now what?  How do I apply the update without losing my changes?   Excellent question and exactly what this post is meant to answer.  We propose the best way to update a Genesis child theme is manually applying the changes you would like to implement.

  1. First, please know that updating is NOT required — this is purely optional as the changes are largely cosmetic styling and added developer feature support .  In the event there is ever a security-related update that we recommend for everyone, we would notify you via email with specific instructions on what and how to update.
  2. If you’d like to proceed, download the latest version of Utility Pro by logging into your account and click the “View Details and Downloads” link on the product entry.  You’ll notice the links have been updated to reflect the latest version.
  3. Next, identify the files that have changed.
  4. Before making any changes, BACK UP THAT SITE !
  5. For new files (if any), you can drop those into your site taking note of the location within the theme folder structure.
  6. For changed files applicable to your theme, we suggest comparing a local copy of the file that currently exists on your live site to the new version, using the diff tool of your choice.  A couple of free tools you can use for this:
    • Online:  Diff Checker – is a website that offers the ability to drag and drop each file you’d like to compare on the screen then click the Find Difference! button.  Manually cut and paste  any differences from the new version to your existing copy then upload to your live site.
    • Application: DiffMerge – is a handy cross-platform tool from SourceGear that I’ve used for years that you can download for OS X or Windows.  This app gives you the ability to compare two files (or folders), and merge the changes individually from one file to another while viewing.  After saving your local copy, then upload to your live site.

For Developer’s Edition Only

There are a few new modules included with your developer’s edition that need to be installed, or you will receive errors the first time you launch “grunt” at the command line:

screenshot of 1.2 version update grunt errors

To correct this, run the following three commands, one at a time until each one completes, and then you can resume business as usual by running “grunt”:

  1. sudo npm install -g composer
  2. sudo npm install grunt-contrib-copy
  3. sudo npm install grunt-rtlcss

That’s all there is to it!  Of course if you have any questions, we’re available to help – just fire off a support request.

 

Utility Pro Theme Change Log

All notable changes will be documented in this file and updated for each theme version release.

1.3.2 – 2017-09-07

  • Fixed name discrepancies in localized property names for the responsive menus. This resulted in errors when evaluating a site via http://wave.webaim.org/ on sub menu items in the primary navigation.

Files Changed:

utility-pro/

bower.json * (version bump only)
package.json * (version bump only)
style-rtl.css (version bump only)
style.css (version bump only)

utility-pro/includes/

enqueue-assets.php

utility-pro/assets/scss/ *

style.scss * (version bump only)

* Developer version files

1.3.1 – 2016-04-11

  • Fixed incorrect script handle on backstretch arguments.

Files Changed:

utility-pro/

bower.json * (version bump only)
package.json * (version bump only)
style-rtl.css (version bump only)
style.css (version bump only)

utility-pro/includes/

enqueue-assets.php

utility-pro/assets/scss/ *

style.scss * (version bump only)

* Developer version files

1.3.0 – 2016-04-06

  • Added theme support for Genesis Accessibility. (404 page, Headings, Skip Links)
  • Added skip link footer navigation.
  • Added mobile “hamburger” menu to footer navigation.
  • Removed theme support for Genesis Drop Down Menus (conflict with Superfish).
  • Improved mobile menu experience for non-visual users.
  • Updated backstretch script to include an alt attribute for the background image.
  • Added support for retina logos.
  • Updated .pot file for translations.
  • Re-organized Grunt tasks to group related tasks.
  • Added Composer support.
  • Added PHP_CodeSniffer support

Files Changed:

utility-pro/

bower.json *
functions.php
gruntfile.js *
package.json *
style-rtl.css
style.css

utility-pro/assets/scss/ *

style.scss *

utility-pro/assets/scss/partials/ *

_header.scss *
_navigation.scss *
_theme-colors.scss *

utility-pro/images/

logo.png
logo.svg
logo@2x.png

utility-pro/includes/

enqueue-assets.php
suggested-plugins.php
theme-config.php

utility-pro/js/

backstretch.min.js
genwpacc-dropdown.js
responsive-menu.args.js
responsive-menu.js
responsive-menu.min.js

utility-pro/languages/

utility-pro.pot

* Developer version files

1.2.0 – 2016-02-06

  • Added h1 markup to site title on a static front page.
  • Added Composer support, specifically for including TGMPA.
  • Added support for PHP_CodeSniffer.
  • Added theme support for Genesis Accessibility (404 page, Drop Down Menus, Headings, Skip Links).
  • Switched from CSSJanus to RTLCSS for style-rtl.css generation.
  • Fixed incorrect variable name resulting from update to TGMPA 2.5.2.
  • Fixed issue with homepage background image sometimes scrolling beyond footer.
  • Fixed issue with content following column classes not float clearing.
  • Adjusted search form width in the header right widget area.
  • Removed sample content (utility-pro.xml) from theme and relocated to user account area.
  • Removed copyright reference from footer creds.

Files Changed:

utility-pro/

bower.json *
composer.json
composer.lock
front-page.php
functions.php
gruntfile.js *
package.json *
phpcs.xml
style-rtl.css
style.css

utility-pro/assets/scss/ *

style.scss *

utility-pro/assets/scss/partials/ *

_accessibility.scss *
_content-area.scss *
_header.scss *
_layout.scss *
_navigation.scss *

utility-pro/includes/

enqueue-assets.php
suggested-plugins.php
theme-config.php

* Developer version files

1.1.1 – 2015-12-11

  • Updated TGMPA to 2.5.2.
  • Removed a forced full-width layout for the front page.

1.1.0 – 2015-07-03

  • Added Sass, Bourbon, and Neat.
  • Changed minimum WordPress version compatability to 4.1 (to accommodate `the_posts_pagination()` ).
  • Added Bulgarian translation.
  • Updated TGMPA to 2.5.0-RC.
  • Fixed the majority of WordPress Code Standards errors and warnings.
  • Changed CSS selector in menu to work with the WP Accessibility plugin toolbar.
  • Added Grunt Clean.

1.0.1 – 2015-02-05

  • Fixed text domain loading for language files.
  • Fixed backstretch image overflow for RTL.
  • Changed search form for improved accessibility.
  • Added British English translation.
  • Added German translation.

1.0.0 – 2015-01-16

Initial release

WP Development Workflow First-Time Setup

I really enjoyed Carrie and Mika on the WP Development Workflow webinar series.  Unfortunately though, my Macbook Pro was not feeling the nerd love that I was.   I had several bumps in the road attempting to set up Node.js, Bower, Grunt and SASS.  That said, I did eventually get everything working and thought I’d share a step-by-step list that others might find helpful.

  1. Node.js – I downloaded the latest version via an OS X install package from the web site .  The first go-round I also installed Homebrew but realized I didn’t need both.
  2. npm – Per the webinar instructions, in Terminal I  navigated to the Utility Pro project folder and ran: npm install. (Remember, this is because it needs the content of that package.json file to know what to run.) This will take awhile as it’s going to load a LOT of files. You might get some warning messages about some version of this or that being deprecated and you should get a new version — I found you can ignore these. Since they are warnings, it will continue with the script and in the end I didn’t have to update anything to get this working.
  3. Bower – Per the next instructions, I tried to run npm install -g bower and received many Permission Denied errors. FYI, the -g means you are installing for global access, meaning it can be accessed from any directory on your machine. To get that to work you need to execute the command as an administrator, or sudo. I re-ran the command but placed sudo in front: sudo npm install -g bower , it prompted for my password (for my Mac), I entered it and it completed successfully.

    If you’ve never done this its a little weird in that while you’re typing your password, the cursor doesn’t move, but it is recording your keystrokes so never fear, press enter when done entering your password and it will continue.

  4. Grunt – Now is the big moment!  Time to finally run Grunt….I type it in and alas I get the error message -bash grunt: command not found  Argh! I started Googling and some posts said to make sure everything is up-to-date and provided a command to do that: sudo npm update -g npm . This appeared to run OK but at the end it had several messages that started with npm WARN EBUNDLEOVERRIDE Replacing bundled npm > -some package- with new installed version. Well, this set of warning messages were not OK to ignore.  So, bottom line:  DO NOT DO THE UPDATE.  So what now?  I Google’d some more about my original command-not-found error and ended up at the Getting Started link for Grunt.  This talked about installing the Grunt CLI (command line interface) globally (need to use sudo) which means it will put the grunt command in your system path, thus allowing it to be run from any location.  Remember, Grunt is package/project specific so you may have that installed in any number of sites.  NOW this was starting to make more sense.   The command to enter is: sudo npm install -g grunt-cli
  5. Sass – So after I installed the Grunt CLI, I typed grunt at the command line and it was doing something, yay! It said something about Bower components and that it re-created the file “style-rtl.css”. Then it said Running "sass:dist" (sass) and it aborted from warnings: Warning: You need to have Ruby and Sass installed and in your PATH for this task to work. More info: https//github.com/gruntjs/grunt-contrib-sass USE -- force to continue. Oh brother, more files missing 🙁 but never fear, you’re almost there! Next step, use the link in the error message which took me to a github README.md file. In there under the SASS heading it repeated — you have to have Ruby and SASS installed for this to run. Well since I’m on a fairly recent Mac, it’s going to have Ruby but I made sure by entering ruby -v in terminal and that checked out. You need that so you can do the next, and final (I promise) task to run which is installing SASS. Funny considering all this was to use that in first place 🙂  So back in terminal, with sudo (your password) enter sudo gem install sass and that to load SASS and you are done. Now go back and enter grunt it will list any partial files that changed, mention that its re-generating new style-rtl.css and style.css files, and it will end with “Waiting…” now you are golden!

screen shot of a successful grunt run

 

Configuring the Genesis Theme Settings

In your WordPress admin, navigate to Genesis > Theme Settings. Configure the Theme Settings as follows:

Color Style

From the “Color Style” dropdown, select your desired color for the theme.

Color Style

Default Layout

The Utility Pro theme supports three layout options: Content/Sidebar, Sidebar/Content, and Full Width Content.

  • Click a thumbnail to select the Default Layout.
  • The Utility Pro demo uses the Content/Sidebar layout. (This is for interior pages, it doesn’t effect the homepage.

Default Layout

Content Archives

  1. For Content Archives, the default setting of “Display post content” is used by the demo.
  2. Set the “Limit content to __ characters” option to 300 to look like the demo.
  3. Check the “Include the Featured Image?” checkbox and select the “thumbnail” for the “Image Size”.
  4. Leave “Numeric” selected for the “Post Navigation Technique.”

Content Archive Options - Utility

Don’t forget to click the “Save Settings” button!