{"id":1957568,"date":"2022-01-25T04:47:28","date_gmt":"2022-01-25T12:47:28","guid":{"rendered":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/?post_type=post&p=1951780"},"modified":"2023-10-27T09:21:16","modified_gmt":"2023-10-27T13:21:16","slug":"prepare-your-site-for-the-removal-of-v1-legacy-views-2","status":"publish","type":"post","link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/prepare-your-site-for-the-removal-of-v1-legacy-views-2\/","title":{"rendered":"Prepare your Site for the Removal of V1 Legacy Views- Update"},"content":{"rendered":"\n

If you are still using the legacy calendar views when you update to The Events Calendar 6.0, your site will automatically switch to our upgraded views. <\/strong>This article walks you through how to prepare and test your site to make the transition as smooth as possible. <\/p>\n\n\n\n

These steps only apply to sites that are still using a 5.x version of The Events Calendar.<\/strong><\/p>\n\n\n\n

Read more about the legacy views removal<\/a><\/p>\n\n\n\n

How do I know if my site is on V1 or V2?<\/h2>\n\n\n\n

Open the WordPress dashboard and go to Events > Settings > Display<\/strong>. The fourth option on the page is Use updated calendar designs. <\/em>If that setting is enabled (checked), you are using the V2 views, and this update will not impact your site. If that setting is not enabled (unchecked) then you are still on the legacy views and should follow this tutorial to prepare your site.<\/p>\n\n\n\n

\"Events<\/figure>\n\n\n\n

If you or a developer have customized your site, it\u2019s also possible that you have V2 de-activated manually via a WordPress function<\/a>\u2013even if the Use updated calendar designs <\/em>setting is enabled. If you\u2019re not sure, go to your calendar. If you see a Today <\/em>button<\/a>, your site is running V2, and you\u2019re good to go.<\/p>\n\n\n\n

\"Today<\/figure>\n\n\n\n

Step One: Update on a staging site<\/h2>\n\n\n\n

If you do not yet have a staging site to test with, you\u2019ll first need to create one. We\u2019ve got a separate article here<\/a> all about the importance of staging sites and how to make one. We\u2019d recommend that you also activate WP Debug<\/a> on your staging site. Make sure your staging site is set up properly and current with your live site so that your testing is accurate.<\/p>\n\n\n\n

Next, update The Events Calendar to the latest version. If you have Events Calendar Pro, Event Tickets, or any of our other plugins, you\u2019ll want to update those as well.<\/p>\n\n\n\n

Once you update, you\u2019ll be prompted to check out your calendar views and make sure you like how things look. Doing that review on a staging site means you can take your time and address any issues before they impact your live site.<\/p>\n\n\n\n

Note: <\/strong>You\u2019ll also be prompted to migrate your events to the new event data storage system, which is a major change in The Events Calendar 6.0. For the purposes of testing views,<\/strong> you can ignore this. <\/strong>Once you\u2019ve completed the views testing, you can go through the migration on your test site as an additional check before updating and migrating on your live site. Read more about the migration<\/a>.<\/p>\n\n\n\n

Step Two: Troubleshoot any issues<\/h2>\n\n\n\n

Now you are ready to start testing and troubleshooting<\/a> any issues you see on your staging site. The idea is to find any errors, broken functionality, or styling issues now so that you can mitigate them before they can impact your live site.<\/p>\n\n\n\n

Errors & Broken Functionality<\/h3>\n\n\n\n

If your staging site is showing errors or not working as you\u2019d expect, you can systematically review your extensions, plugins, and customizations to determine what\u2019s causing the conflict. Start by deactivating any other plugins on your site, one at a time. After each one, check again for the error or problem you saw. If the issue disappears, you can then confirm that the last plugin you deactivated was causing a conflict.<\/p>\n\n\n\n

If you find an issue with one of our extensions, it\u2019s possible you just need a new version\u2013many of our extensions have been updated recently to work with the V2 system. Unlike regular plugins, new versions of the extensions don\u2019t appear in your WordPress admin, so you\u2019ll need to check the extension library<\/a> and see if an update is available. If the issue is with a third-party plugin, you can reach out to the developer and explain what\u2019s happening so that they can add compatibility with the updated V2 views.<\/p>\n\n\n\n

You can follow a similar process to review any customizations you\u2019ve made to your site that could be causing errors. Remove your customizations one at a time and use that to narrow down which is causing warnings or other issues when used with V2. If you run into an issue with a snippet provided by The Events Calendar team, check out our knowledgebase<\/a>. As with the extensions, we\u2019ve updated many of our knowledgebase articles to include solutions for the V2 views. If the culprit is one of your own modifications, the knowledgebase is also a great place to start looking for a way to adjust it to work within the V2 views.<\/p>\n\n\n\n

Styling Issues<\/h3>\n\n\n\n

The V2 views have a new modern design and you\u2019ll see the difference right away on the front end. Depending on your theme and any customizations, you may also see some unexpected or unwanted changes.<\/p>\n\n\n\n

Just as you did with plugins, one of the best troubleshooting steps is to look for a theme conflict. Try switching to a WordPress default theme (e.g. Twenty Twenty or Twenty Twenty-One) and see if the issue(s) you\u2019re experiencing persist. If the issue is resolved, you know that it has to do with a theme conflict. We recommend reaching out to the theme developer\u2013it\u2019s possible they need to make some changes to be compatible with the updated views.<\/p>\n\n\n\n

If you had made customizations to the legacy view templates, those customizations will not impact the site once it\u2019s running V2. The new system has a completely different set of templates. However, the new templates are designed specifically to make customizing easier. We\u2019ve got a whole set of articles to help you get started with customizing the new views. Here are a few links to get you started:<\/p>\n\n\n\n