Home Forums Weaver X Tutorials and Hints Converting a Weaver II (Pro) or Aspen site to Weaver Xtreme.

Viewing 16 posts - 1 through 16 (of 30 total)
  • Author
  • #17438

    IMPORTANT: This Tutorial has been moved Over to the New Weaver Guide site below
    Note 2: This will apply to Aspen with little differences
    Read the whole document first, and visit http://demo.weavertheme.com/ to get some global visibility and ideas before starting the process.

    1) Preparation

    a- Database backup
    First Download a full backup of your site including the database. There is really no risk in the conversion process, but some of it involves making permanent changes in the database so you are always better safe than sorry.

    b- Settings file
    Within the Admin of your Weaver II site, go to save restore, and click on Download ALL settings (w2b file). You will need this file for the conversion, and it will also be a good backup to keep in case you did need to restore the weaver II site.

    c- Widgets
    One thing WordPress messes up when switching theme are widgets. You should go in Appearance > Widgets, open each widget area and take a note of what widgets are in each of them.

    d- Shortcode content
    Until Weavers Shorctode conversion plugin is done, gather content from things like Social icons, Link Buttons, Shortcoder…
    EDIT: the plugin is now available https://wordpress.org/plugins/weaver-themes-shortcode-compatibility

    e- Theme and Plugins

    – In Appearance > Theme > Add new, Search for Weaver Xtreme, and Install the theme. Do Not Activate yet.
    – In Plugins > Add New, Search For Weaver Xtreme Theme Support, and install the Weaver X Theme support plugin. Do Not Activate yet.
    – If you bought the “Plus” Plugin, in Plugins > Add New , Download and install the “Plus” Plugin Zip file you downloaded for the site you bought it from. Do Not Activate yet.
    – In Plugin, Search for “weaver-ii-to-weaver-xtreme”, Download, install AND activate it. Or “Aspen to weaver Xtreme”
    – In Plugin, Search for “Weaver Theme shortcode Compatibility”  Download, install, Do Not Activate yet.
    – If you used the [weaver_show_posts] shortcode, you want to search for “Weaver Show Posts” (used to be ATW Show posts), Download, Install AND Activate.

    2) Converting Settings

    A- First read through the Plugin Help page in Tools > Weaver Converter > Help (from the main WordPress left menu bar)

    B- Then in the Main Plugin page Tools > Weaver Converter > Conversion option section, you can browse to the w2b setting file you just downloaded, and click “Upload convert theme/backup” to convert the setting file.
    After the conversion is done, you get a detailed list of the conversion result. That lists will also be available after you have transitioned to Xtreme.

    Note 1: The Setting conversion does not do anything to your site, it just creates a New Xtreme Setting file that you can then download and use once you will have activated Xtreme.

    C- Next click “Download” to actually download the Xtreme setting file (wxb file).

    D- Then click the Download button below that downloads converted shortcodes settings for the “plus” plugin.

    Note 2: The next section of the converter is the “Convert Per Page and Per Post Settings “. This section will actually modify your pages options to match Xtreme.

    If you cannot disturb your site long enough to complete all the process in one go, you will be able to go back to Weaver II at any time and have your site undisturbed. When you switch back to Weaver II (pro) it automatically loads the Weaver II settings and everything looks the way it used to.

    This allows you to take your time with the settings conversion, by activating Xtreme, working on the settings, then going back to Weaver II so the site can still be viewed normally until you have time to work on the conversion some more.

    3) Configuring Xtreme Settings

    IMPORTANT: At any point during this process, you can go back and activate Weaver II (Pro) to check how things where under the old theme, them come back and activate Xtreme to implement a change.

    a- Loading converted settings

    • In Appearance > Theme, Activate the Xtreme Theme. As you do that, realize your site will no longer look correct, so do that at an appropriate time.

    Note: If your site should not be disturbed, you should clone your site in a sub folder or sub domain, and execute this whole process on the cloned site first. This would allow you to finalize all the settings for the Xtreme theme without disturbing your live site, and only apply these to the live site when you have worked out all the details. If you need help with cloning your site, read the article on the subject in the FAQ http://weavertheme.com/migrate-your-site-to-new-domain-name-or-new-server/

    • Then in Plugins, activate the following plugins:

    o Weaver X Theme Support
    o “Plus” if you have it. If you do, after activating the plugin, also activate the “Plus” License in Appearance >  + Xtreme plus > Activate

    • In Appearance > Weaver Xtreme admin > Main Options > Save/Restore > Upload settings from file saved on your computer, Browse to the converted Xtreme setting file you downloaded previously after conversion, and click “Upload Theme backup”
    This will load all the converted settings.

    Note: You site probably still looks like a mess, don’t worry and read on.

    b- Fixing WordPress settings
    When you switch theme you lose WordPress settings, so you need to redo these manually

    – Reselect your header image if you had one previously selected
    – Reset your overall background image if you had use WP to do that in Weaver II
    – Move your widgets back in their proper location.

    The biggest mess after switching theme, is that widgets sometimes end up all over the place. You need to go to Appearance > Widgets, and move your widgets back to where they were. Some will have been moved to a different area, some will be in the unused area. Use your notes to know which one goes where.

    As sidebar and other widget areas are different in Xtreme, You may need to experiment with some new choices. The biggest change may be with sidebar widgets. Xtreme has only two Sidebar widget areas, primary and secondary, that are stacked up. If you used side by side widget areas layout in Weaver II, you may need to put widgets from two weaver II sidebar widget areas in the same one under Xtreme, then use the Sidebar widget layout options to make them side by side.

    c- Finalizing settings changes manually

    Note: By now things should start looking better but there are still a number of things to finalize manually

    1- Sidebar layouts
    As explained above, you will need to reselect global sidebar layouts in Main Options > Sidebar &Layout. Don’t worry about per page layout settings for now. Note the new mobile stacking choices and take advantage of them.

    2- Menus
    Your custom menus will still be there, but they probably wont be allocated to primary, secondary. Go to Appearance > Menus >Manage Locations, and reselect the right menus. Note, there is now a mini menu you can allocate too.

    3- Fonts.
    These are handled differently in Xtreme, so you need to go in each page under Main options, and select the proper font family for each area, as well as eventually adjust the size settings. If you used google fonts, you will have to set them up in Main options > Fonts & Custom.

    4- Colors
    Because some areas are different in Xtreme, you may need to set some colors here and there

    5- Custom CSS
    If you had a lot of extra customization, this will be the major part of the work.
    Custom CSS Rules in Options CSS+ Boxes will most likely be fine.
    Custom CSS rules in Main Options > Fonts & Custom > Custom CSS Rule box will have to all be examined one by one to see if they are still relevant and have the right syntax.
    Hopefully you had commented your custom CSS rules so you will know what each one is for. If not you will need to do some inspection with your browser developer tool 

    For each rule there will be 3 possibilities
    – The rule still works and still does something that is needed: Just keep it
    – The rule does not work because its syntax no longer matches Xtreme and what it did is missing :
    You first need to inspect if there is now a new option in Xtreme that can do that for you. If so use the new option(s) and delete the rule.
    If there is no option(s) do to the job, you need to figure out the new syntax / selectors to use (we can help with that).
    – The rule does not work, and what it did is no longer an issue > Just delete the rule.

    What I found out, is that most of the tweaking rules I had in Weaver II ended up being unnecessary in Xtreme. A number of the valid rules I had did have a new option in Xtreme that I could use. All an all my Custom CSS went way down on Xtreme.

    Note: This would be a good time to go to Main Options > Save Restore > Click Save Settings (to back up your Xtreme settings in the database) 

    6- Customized layouts using HTML Insertion areas and widget areas (header / footer).

    If you had built very customized header/footer using HTML Insertion and widget areas, you may need to revisit how it was done in the light of the new tools and areas in Xtreme. Review the Insertion area page of the demo site http://demo.weavertheme.com/insertion-areas/ and the other ones to gather Xtreme layout ideas/solutions, and eventually reproduce your design using the new tools.
    Other thread that may be useful:

    At this point your site should mostly be there, exception for Per Page options and Shortcode related content.
    As mentioned previously so far, you can switch back to Weaver II (Pro) and be back exactly where you were. The next steps will be final as they will implement changes in your pages / posts and content, that will no longer be compatible with Weaver II.
    So if you are ready to finalize the switch go to the next step.




    4) Pages. Posts. Content specific changes

    • Go back to Tools > Weaver Converter > Convert Per Page and Per Post Settings section.
    • First Click on “Generate Per Page/Post Pre Conversion report”. This will show you all that will be done, and you can see if some things won’t convert and what they are.
    • Then Click “Convert Per Page/Post settings” to execute the conversion
    • Now go through each page of your site and check if there are still things that need to be done like:

    – Adjusting the sidebar configuration, taking advantage of the new stacking modes that area available for mobile.
    – If you used Custom Fields check if they are using the proper/best HTML Insertion Area
    – Take advantage of the numerous new per page options.
    – If you have “Plus”, Pages now have a “per page style box”, so if you had page specific Custom CSS rule starting with .page-id-xxxx you could move these in their respective pages.

    5) Shortcodes

    • Shortcode content:
      In + Xtreme Plus > Xplus Save/Restore > Restore settings from your computer, browse to the wxplus file downloaded earlier and click “restore options from Specified file”.    
    • Activate the Weaver Theme Compatibility plugin. If you get messages indicating some shortcode cannot be made compatible, you will have to go and edit these manually

    You may have to change their name like from  weaver_xxxx to just xxxx as well as their options if not identical in Xtreme and Weaver II.

    • If you used the [weaver_show_posts] shortcode, You will need to use the Weaver Show posts plugin (used to be called ATW show posts) to create the new equivalents of your shortcodes. Weaver Show post gives you the same functionality plus more, with a much easier user Interface to configure what you need. If can also be combined with Weaver SHow slider to create post sliders.

    6) Final Review

    Once you have everything done, take the time to go through all your site pages examine the mobile behavior, and think if some of the new Xtreme features would actually allow you to do a better job than before.
    If you have “Plus” one of the areas that you can improve, are the behavior of multiple widgets in widget areas. You can now define variable width for each widget and decide for a different layout on desktop, small tablets and phones. You can also equalize the widget height if you are using a widget background. (Check the tutorials index linked previously)

    7) Backup

    Last but not least, go to Main options > Save / Restore, Click Save Settings to make a copy in the database, and click Download All Settings to keep a local copy.
    If you have “Plus”, go to + Xtreme Plus > Xplus Save/Restore page, and Click Download Save ALL Settings, to download a local copy of EVERYTHING…

    NOTE: A user reported the  following issue http://forum.weavertheme.com/discussion/12539/tip-when-converting-from-weaver-ii-pro-to-xtreme-deactivate-wp-minify

    WP Minify combines and compresses JS and CSS files to improve page load time.

    Tip: When you convert your website from Weaver II-pro to Extreme, (temporary) de-activate the WP Minify plugin because your JavaScripts will be totally messed up resulting in HTTP Error code 400: Bad requests.

    As usual if I messed up something, speak up, and feel free to add your own experience with this process 


    Just one extra point – I also had to reallocate my menus to their locations.  The menus were intact, but just not allocated. I don’t know if this was because I did something out of order during my conversion, or whether this might be expected.

    Moderator’s note: This is WordPress behavior. It does not carry Menus, Header Image, nor Background colors over from one theme to another one.


    @scrambler – this is great thanks!! 

    Just working my way through it and I have a question – I have Weaver II Pro (and have gone for the Xtreme Plus option).  When I convert the weaver ii settings, I also get a second file to download ie pre_xtreme_weaver-ii-backup-settings-date.wxplus   This isn’t mentioned in your instructions. 

    When and how do I upload this – I assume straight after I upload the main conversion file?  Using the same Appearance > Theme Options > Main Options >
    Save/Restore > Upload ?? Or do I upload it to the Plus plugin restore/save area?


    The .wxplus file needs to be uploade from the Xtreme Plus Save/Restore menu.


    This is taking forever, but am slowly getting it right. Some of the conversions made no sense such as the color of page titles, bottom borders, etc., but that was an easy fix. I am so glad I cloned the site I wanted to convert and thus am able to bring up both versions to go back and forth with.

    What I cannot seem to get back is the report that told me what didn’t auto convert and what I had to do manually. I saw it on screen once, but can”t seem to find it again.

    Where is the option for the font-size (and family) for the input area text button? 

    You can simply run the conversion again to regenerate the report. Just reload the original Weaver II settings file you used, and you’ll see the same report.

    The conversion is totally non-destructive – as far as the normal options settings go, nothing is applied until you save the converted settings and then load the converted .wxt or .wxb file directly.

    The only one-shot conversion is the conversion of the Per Page/Per Post settings. You can re-run the Per Page conversion to get the report again, but the settings are only converted the first time you click the convert button. Any other time, you’ll get the report, but the settings are not created again. Even so, this conversion is non-destructive in the sense that the original Weaver II per page/post settings are retained. The per page/post conversion needs to be done on the actual content of the final site – either on a duplicate of the site that you plan to transfer to the original site, or on the original site itself. This is because unlike the theme settings which are in a separate database entry and can be saved to a settings file, the per page/post options are associated directly with each page or post’s content, and exist only on the site with those specific pages and posts.


    I am working my way from converting one of my simpler sites from Weaver II Pro to Weaver Xtreme Plus.  So far with scramblers instructions things are going well and are actually pretty painless (thanks for the work in documenting this).

    I installed the “Weaver Themes Shortcode Compatibilty” plugin prior to running the conversion plugin.  As part of the conversion (I have not run the Per Page/per Post conversion yet) the  .wxb file was created but there was no .wxplus file created.

    Was this because:
    1. I did not perform the steps correctly.
    2. I did not run the Per Page/Per Post conversion yet
    3. There are no shortcodes to convert?

    Thanks for the help – Bob


    Once you do the conversion, there are Two download buttons. One for the theme and one for the plus plugin (Steps below)

    Did you click on both download buttons ?

    2) Converting Settings

    A- First read through the Plugin Help page in Tools > Weaver Converter > Help (from the main WordPress left menu bar)

    B- Then in the Main Plugin page Tools > Weaver Converter > Conversion option section, you can browse to the w2b setting file you just downloaded, and click “Upload convert theme/backup” to convert the setting file.
    After the conversion is done, you get a detailed list of the conversion result. That lists will also be available after you have transitioned to Xtreme.

    Note 1: The Setting conversion does not do anything to your site, it just creates a New Xtreme Setting file that you can then download and use once you will have activated Xtreme.

    C- Next click “Download” to actually download the Xtreme setting file wxb file).

    D- Then click the Download button below that downloads converted shortcodes settings for the “plus” plugin.


    Thanks scrambler.  No I did not do option D ( I never noticed the 2nd download option).  I ran the plus download and then restored the file via the plus save/restore and my shortcodes were added.  – Bob


    In reference to step #5 Shortcodes

    • Go to the  Weaver Theme compatibility plugin, and convert the shortcodes

    the shortcode conversion. Some just have their name converted from
    weaver_xxxx to just xxxx as their options are identical in Xtreme and
    Weaver II, like weaver_php weaver_youtube…. Some will also have their
    options to be changed to the new ones like [weaver_show_if_mobile] that
    would use [show_if device=’mobile’]  etc…

    I have the Weaver Themes Shortcode Compatibility plugin installed and actived, but how do I access it to convert the shortcodes as showing in step #5? – Bob


    Not having used the plugin as it was not available at the time, I may have misunderstood what it did and caused a confusion with my phrase “convert the shortcodes”

    It looks like you may not have to run a conversion and that the plugin just takes care of the compatibility without making any changes to the shortcodes.

    @weaver can you confirm if this plugin requires no action and just makes the shortcode whatever they are compatible. If not can you detail how to use it as I did not find anything either


    At one point, the intention was to provide conversions for incompatible shortcode, that that proved to be just too difficult. So incompatible shortcodes (like the show_if) will require manual conversion. If there are any converter blurbs that still say that, please point me to them so I can fix it.


    I am still not clear, Does the plugin requires and action to run a conversion, Or when you activate the plugin, does it just makes old shortcode works.

    What is not clear is do you need to take any other step, other than activate the plugin ?


    Activate the plugin, and most previous Weaver II shortcodes will work without any other effort. If it was not possible to create an equivalent working shortcode in the plugin, it outputs a message indicating the shortcode is not supported by the plugin. Such incompatible shortcodes will require manual handling to either remove the functionality, or perhaps find an equivalent way to accomplish it.

    Edit: [weaver_show_posts] is a major exception – it must be manually converted to ATW [show_posts].

    Weaver II Pro shortcodes will be covered by the next release of Weaver Xtreme Plus, and again, it does not handle ALL Weaver II Pro shortcode (like the menu slider, for example.)


    Thanks for the clarification.

Viewing 16 posts - 1 through 16 (of 30 total)
  • The topic ‘ Converting a Weaver II (Pro) or Aspen site to Weaver Xtreme.’ is closed to new replies.