Upgrade from 1.10.x to 2.0.x
Settings required after the Upgrade
- All your blogs will be assigned to the default skin again
- Go to Global Settings > Skins and install any third party/custom skin you want to use; you may also remove skins you don’t want to use
- Go to Blog Settings > Skin and pick the skin you want for each of your blogs
- Go to Blog Settings > Widgets and select the widgets/plugins you want to display in each blog’s sidebar
- Go to Blog Settings > Advanced for Blog #1 and enter the IDs of the blogs you want to aggregate. Blog #1 no longer needs to aggregate everything, nor does it actually need to aggregate anything at all ;) Note: Include blog #1 itself in the list if you have posted articles directly to blog #1.
- If you use scheduled tasks (and you should), go to Tools > Scheduler and delete your current recurring tasks (Antispam poll, hit pruning) as they will fail repeatedly. Re-add these jobs in 2.0. (This is now done automatically by the installer in version 2.0.2)
Blog 1 used to be called Blog All and aggregated all my other blogs. Where is Blog All now?
In versions prior to 2.x, blog 1 used to aggregate all posts from all blogs. When you upgrade that behaviour is off by default. You can now make ANY blog aggregate posts from any other blogs, so that’s a big improvement! Blog 1 is not special anymore.
But if you upgrade an existing installation to 2.0 or higher, you will now take a new approach to creating a page that aggregates posts.
Go to Blog Settings and select the blog you want to aggregate other posts into (in this case your blog n° 1), then select the Advanced sub-tab. There you will see a field for what blogs to aggregate. It is a comma-separated list of blogs, such as, 1,2,4,7,19. Enter your comma-separated blog numbers and save the changes.
One of the biggest benefits of this is that we can now show posts in all blogs EXCEPT the linkblog on our the blog we choose to serve as our aggregator.
If you are using your own (custom) skin, you will need to operate some changes to make it work with version 2.0. The following should do the trick:
- Rename your main CSS file from whatever name it had to "style.css" which is the standard way of calling the main skin CSS file in b2evo 2.x.
- At the top of your CSS file, make sure you include at a minimum the following:
otherwise your toolbar will be all borked.
- Rename your main skin template
index.main.php. Then edit that file with the following changes:
- In version 2.0, initialization of the blog data is optimized depending on what we are about to display. An RSS skin would be different from an HTML skin. For general purpose skins, add this at the top of your main template:
Note: the above block also automagically includes the HTML header, so you can just delete anything up to and include the
- In versions 1.x, posts contents were displayed by
<?php $Item->content() ?>. In 2.0, this will fail miserably. use this instead:
- In 1.x, links to pages in multipage posts were displayed by
<?php link_pages() ?>. This is no longer needed as it is handled by the block above. You can delete that part.
- In 1.x, links to other pages in the list of posts posts were displayed by
<?php posts_nav_link() ?>. In 2.0, this again will fail miserably. use this instead:
- Replace the block that includes feedback, i-e the block looking like:
- You can remove the line staring with:
- Your current sidebar may or may not work with 2.0. Either way, you’ll probably want to delete it completely and replace it with the following container code: (you’ll then use the backoffice to choose which widgets and plugins should go into the sidebar):
Additionally, please note that "Skintags" or "Skintag plugins" now fall under the category of "Widgets". Widgets can either be provided by the core or by a plugin.
- Some of the default widgets have slightly different params than before. Among which:
- title should no longer include markup
line_startis replaced by
line_endis replaced by
- On a related note, if you are including a list of blogs at the top of your skin, you can no longer do that like this:
You now need to add a widget container and later place the blog list widget into that container (you’ll do that in the admin interface > blog settings > widgets). Use this to insert a container on top of the skin:
- You may want to add a link to contact the blog owner through a form:
- Ideally, you would include the standard headers and footers. This is not mandatory though. Check out the custom skin for guidance.