Support » Plugin: The Events Calendar » [Plugin: The Events Calendar] WALKTHROUGH: The 6 Steps to upgrading from 1.6.5 to 2.0

  • Plugin Author Shane Pearlman


    The largest change in 2.0 is the move from having events live in regular posts to the (somewhat new) WordPress custom post types. This means that events are no longer going to appear in your posts but rather in their own panel called events. Part of the process of upgrading is to move your events (we have a magic button).

    STEP -1: OOPS – I didn’t want to update. No problem, you can easily revert. Grab a copy of the version of the events plugin you want here: and add it to your plugins folder. Deactivate the new one and activate the old one your just upload. All better.

    Ready to Go?

    STEP 1: Before you do anything: BACK UP YOUR SITE. That way if you run into challenges you can revert if you have to. We use backup buddy and are extremely happy we do as we have had to restore numerous times over the years while playing with WordPress & Plugin updates.

    STEP 2: Click update in the plugin admin or download and add it manually.

    STEP 3: Migrate! In order to migrate your events after you activate the plugin, you will need to visit the setting panel and click the “Migrate Data!” button. We have some screenshots of the process on our FAQ.

    STEP 4: Reset your permalinks (go to settings > permalinks > hit save). We’ve noticed that a lot of weird issues people have often get solved by this easy step.

    STEP 5: Walk through the setting. The place the most people will run into challenges will be with Themes. We have a new theme integration approach that allow you to pick from any page template (screenshot) the theme offers or from the default event templates we bundle with the plugin. Try different options to see what looks best. If we get lucky, your theme will play nicely and one of these will work out of the box. If not, then you have a few options. There is a before / after html set of text areas to allow you to add any divs etc you might need. Often the issue is simply a little missing css on your main content div and can be added to your theme css file. This may take some noodling. We wish the you the best of luck. Feel free to ask the community for help on this step. People have been great. The plugin devs won’t help on this step unless you have uncovered a legit bug with the plugin as supporting the 100k+ themes in the world is basically impossible and we all want them to stay focused on making awesome features.

    STEP 6 (OPTIONAL): Dealing with custom templates. If you have been noodling in code, odds are extremely high you are going to have to make some fixes.

    The path from open source 1.6.5 to 2.0 has been a long one with years of evolution. As you can imagine the template tags, queries & css have significantly changed over time. The odds of a highly customized theme upgrading cleanly is unlikely. While it may not be a ton of work, some is inevitable. We are actively working on documentation this week and will have it up soon at as it comes out. There are already quite a few items in the FAQ and you are welcome to search the PRO forums to find answers as it fills out.

    Please let us know where you get stuck as you go through the migration process. While we won’t help you code your site, we are on the active lookout for bugs. The more clarity we can get, the faster we can patch those suckers and get everyone an update.

    Hope you all enjoy the significant effort we have put into the new version once you get through the migration and get up and running.

    One quick note: PRO WON’T FIX YOUR SITE. If you are having any issues with the free version, adding PRO won’t make any difference. All PRO offers are some additional features to help you accomplish more awesome things.

Viewing 15 replies - 1 through 15 (of 61 total)
  • Plugin Author Shane Pearlman


    bump, so this doesn’t get too buried.

    Hi Shane,

    I’ve seen a half dozen threads and this one probably makes the most sense to reach out for help on. I get the following error…

    Fatal error: Call to a member function loadDomainStylesScripts() on a non-object in /xx/xx/xx/xx/wp-content/themes/cinch/events/single.php on line 3

    I probably fall into the noodling category, but don;t know how to un-noodle?

    Any suggestions?

    I was able to resolve it by backing-up the ‘events’ folder in the theme and then nuking it. Everything seems to be working now. Hopefully this can help someone else. 🙂

    Plugin Author Shane Pearlman


    Just so everyone follows, what do you mean by backing up?

    (glad you figured it out)

    I mean I dragged it from my website directory to my local machine before I deleted it… just in case. I haven’t had to re-upload it and everything is working well now.

    Plugin Author Rob La Gatta


    Thanks lzevon – that’s good to know and hopefully others will have similar luck with it should they run into this issue.

    My pleasure – great update. I’ll look into the pro version (curious to know if I can use it across multiple sites) after the weekend…

    Plugin Author Shane Pearlman


    pro works on WordPress mu.

    Plugin Author Shane Pearlman


    bump (justing keeping this up top – gee I wish it was sticky).

    Hi Shane,

    I’m having a problem that doesn’t appear to be addressed in the documentation. I have updated the Permalinks structure more than once and I am still having a pathing problem. You can see here that if you click the Events link, it takes you to which does not show the calendar. works, but how do I provide a link to that since the calendar posts are no longer assigned to a regular category? I am not using any widgets in the theme.


    I guess the obvious answer is that I can hard-code the link into the theme and use code to exclude the category link from showing but it seems like there must be a slicker way. Now if I look under Categories in admin it says that I have 39 posts in the Events category, but if I click the 39, it says that there are no posts, which is kind of weird.

    Plugin Author Shane Pearlman


    hi jonas,

    I guess I am not following the issue you are having.

    Events seem to show: as you stated.

    You can add events to your menu in the wordpress menu tool: admin > appearance > menu > events panel(s) > check events. If you don’t see the events panels you can find them in the screen options tab.

    How are you having that menu item created now?

    Hi Shane,

    I actually never mentioned that link (/events/past/) but the link that is there now has always been there as a Category link. That link no longer works (i.e. it no longer displays the calendar). I have to figure that the only way to make the link go away is to write code to exclude it from showing, since the admin says that I have posts in that category, yet when I click to see the posts, there are none.

    Under Menus I get the message “The current theme does not natively support menus, but you can use the “Custom Menu” widget to add any menus you create here to the theme’s sidebar.” so I guess it is possibly a theme issue. I will have to learn how to build menu support into themes but at the same time I am not wild about using custom menus because it becomes a maintenance issue.

    The bigger issue happens to be another site (that I also help maintain for free) that has the latest version of Atahualpa and uses widgets. On that site I am also using the “Page Links To” plugin to show a link to the calendar in the pages menu without using custom menus.


    Plugin Author Shane Pearlman


    Ah, that sounds like a bummer. You have a pretty old theme there. All modern themes in the last year and a half support user managed menus (core wordpress feature). You can either upgrade their theme to the proper wordpress menu system or you can hack their existing approach (omit the category).

    As for why it says you have posts in events but none show, that might be a bug with the migration potentially. I’ll have rob see if he can reproduce it.

    Not familiar with the page links to plugin, so I can help there.

    LOL I wrote the theme. I guess I need to brush up. Like I said I can write code to make it work. The bigger issue is the site that I have not upgraded yet, which uses the latest version of Atahualpa and widgets (and the Page Links To plugin). I’ll try upgrading that site. Seems like you can always go back despite the “this cannot be undone” warning that you get when you migrate the posts.

Viewing 15 replies - 1 through 15 (of 61 total)
  • The topic ‘[Plugin: The Events Calendar] WALKTHROUGH: The 6 Steps to upgrading from 1.6.5 to 2.0’ is closed to new replies.