Focus on your mission, not your tech - Another Cup of Coffee (Posts about WordPress)

Drupal 7 End of Life: Why WordPress is the Best Migration Option for Lower Maintenance Sites

Aiden — Tue, 17 Dec 2024 14:25:15 GMT

Drupal 7 will reach end-of-life in January 2025. Learn why migrating to WordPress makes sense for small businesses, agencies, and anyone looking for an affordable, flexible CMS solution.

Drupal 7 is reaching the end-of-life (EOL) on 5th January 2025. This means official support will stop, leaving around 180,000 websites vulnerable to security risks, compatibility issues, and rising maintenance costs. If your site is still running on Drupal 7, it's time to make a decision.

For many, upgrading to the latest version—currently Drupal 11 which was released in July 2024—might seem like the logical next step. However, the move from Drupal 7 isn't a simple update but rather, it will require a complete rebuild. For smaller teams, freelancers, or businesses, this can mean significant time, money, and stress.

Drupal is well-suited for large, complex websites that require advanced functionality. This includes enterprise-level businesses, government portals, higher education institutions, and NGOs. That said, Drupal's steep learning curve and resource-intensive nature make it less suitable for small businesses or individuals who need a simple, low-maintenance website.

This is where WordPress comes in. With its lower costs, ease of use, and massive community support, WordPress has become the go-to CMS for businesses who need a better balance of simplicity and functionality. Whether you're running a small agency, freelancing, or managing your own business site, WordPress offers a practical, future-proof solution.

Final Deadline Announced After Multiple Extensions

The Drupal Association has announced several end-of-life dates for Drupal 7 over the years:

The latest and final EOL date for Drupal 7 is January 5, 2025, was made to give organizations more time to migrate their websites to newer versions of Drupal or other platforms.

What Happens If You Stay on Drupal 7?

It should go without saying that sticking with Drupal 7 after its End of Life isn't a viable long-term option because it will no longer receive official updates, security patches, or technical support.

This leaves site owners and maintainers with a range of headaches:

Security Risks: Without updates or security patches, your site becomes a prime target for hackers.
Compatibility Issues: Over time, browsers, APIs, and third-party tools will evolve, leaving your site unable to keep up. Things will start breaking—slowly at first, then all at once.
Rising Costs: Developers who still work with Drupal 7 are becoming harder to find, and their rates reflect that scarcity. Maintaining an outdated platform will only get more expensive.

If you're still on Drupal 7, the clock is ticking. It's time to start planning your next move.

Why Choose WordPress Over Upgrading Drupal?

WordPress has grown into the most widely used CMS in the world, powering around 43% of websites and 229,000 of the top 1 million sites by traffic. Popularity isn't the only reason to choose WordPress though.

For starters, it's easier to use because WordPress's intuitive interface means you don't need a developer for every little update. Your team can manage content, make changes, and even build pages without technical expertise.

It's also more affordable. While both Drupal and WordPress are open-source, WordPress generally offers a better return on investment with lower build and maintenance costs. Drupal's complexity leads to higher development expenses and more costly, time-intensive updates.

And then there's WordPress' massive global user base, which means there's no shortage of resources, tutorials, and developers. If you need help, it's easy to find.

Is it Worth Upgrading Drupal?

Upgrading to Drupal 11 is an option, but it's not a simple one. Architecturally, the jump from Drupal 7 to 11 is massive. The two versions are so different that you're essentially rebuilding your site from scratch.

For some organisations, that's fine. Nevertheless, if you're running a complex site with custom features that rely on Drupal's architecture, it might even be necessary. In fact, Drupal is often overkill for smaller businesses or agencies.

Futhermore, Drupal has gravitated towards enterprise-level projects over the past few years so if you don't need that complexity, WordPress is a more practical, cost-effective choice.

Real-World Success Stories

During a recent WP Engine webinar, Emily Averill, Digital Marketing Director at Daniels Health, shared their reasons for migrating from Drupal 7 to WordPress:

"The [Drupal] website wasn’t a place that our team could work confidently or with pace or agility. It was a friction point, and so we wanted a platform that could grow with us as an organization...Yes, it was going to be a hard migration. But in order to achieve the outcome, the future state we really wanted, it was going to be worth it...Replatforming for us in reality has been easier than migrating from Drupal 7 to 10."

This is a common theme among businesses that have made the switch. WordPress's user-friendly interface and flexibility make it a better fit for teams that need to move quickly and efficiently.

How We Handle Migrations at Another Cup of Coffee

Migrating a site can feel overwhelming, especially if you've been on the same platform for years. That's where we come in.

Our Process:

Project Discovery: We analyse your requirements and site's content, custom features, user roles, and integrations.
Migration Planning: We determine what needs to be migrated, what can be replaced with WordPress plugins, and what might need to be rebuilt.
Custom Solutions: If WordPress doesn't have an out-of-the-box solution for something, we'll build it.
Optimisation: Once the migration is complete, we optimise your new site for performance, security, and scalability.
Training: We provide training so your team knows how to manage the new site.

By the time we're finished, you'll have a site that's ready for the future.

Why WordPress is the Smarter Choice Today

Continuing to build on outdated Drupal software not only increases complexity but also creates significant technology debt, making future development more costly and inefficient.

As Scott Jones from Illustrate Digital explains in the WP Engine webinar, continuing on Drupal often means that new features and functionality are being developed on old underlying software and frameworks, which can hinder growth and innovation.

In contrast, WordPress offers a modern, intuitive interface that empowers marketing teams to take control of content publishing without relying heavily on developers. Webinar panelist PeterJohn from Useful Group highlights that WordPress is more marketer focused, while also evolving its developer tools to rival or surpass Drupal.

By migrating to WordPress, businesses can reduce costs, streamline workflows, and future-proof their digital presence.

Let's Talk

If you're still running Drupal 7, it's time to make a move. Whether you're ready to migrate or just exploring your options, we're here to help.

Drupal to WordPress migration service

Any Drupal version · All content · Custom content types · SEO · Plugins

Drupal 7 End of Life Frequently Asked Questions

These FAQs are drawn from the real-world experience of the WP Engine webinar panelists.

Why are organizations moving away from Drupal?

Several factors contribute to the shift away from Drupal, particularly Drupal 7, which reaches its end of life in January 2025. These include:

End of life for older versions: This necessitates full rebuilds, leading to significant effort and cost.
Technological debt: Building new features on outdated software creates challenges and limits agility.
Shifting decision-making: Marketing teams, who are most impacted by the CMS choice, now have a greater say, leading to a preference for more user-friendly platforms.
Rise of alternative platforms: Modern platforms like Next.js and WordPress offer attractive features and benefits.

What are the advantages of WordPress for marketing teams?

WordPress offers several benefits that make it particularly appealing to marketers:

Intuitive content management: WordPress's user-friendly interface and familiar structure make it easy to learn and use, even for junior team members.
Ease of content publishing: The block-based editor and intuitive design streamline content creation and editing.
Extensive plugin ecosystem: A vast library of plugins provides seamless integration with marketing tools and services, expanding functionality without custom development.
Flexibility and agility: WordPress allows for quick site deployment and iterative improvements, enabling rapid responses to market changes and opportunities.

How does WordPress benefit technical teams?

Beyond its marketing advantages, WordPress also offers benefits for developers:

Gentle learning curve: The platform is relatively easy to learn, reducing the training burden and enabling faster onboarding of new team members.
Strong community support: A large and active community provides ample resources, documentation, and support for troubleshooting and development.
Wide choice and flexibility: WordPress offers a vast selection of themes, plugins, and development tools, allowing for customized solutions and integrations.
Scalability and adaptability: WordPress can scale to accommodate large and complex websites, and its open-source nature allows for customization to meet specific needs.

What happens to my Drupal 7 website after January 2025?

No more updates: Drupal will cease releasing feature developments and security updates for Drupal 7.
Increased security risks: Without ongoing security patches, your website becomes vulnerable to exploits and attacks.
Limited functionality: You will no longer receive updates for modules and themes, potentially impacting website performance and functionality.

How do I address security concerns about WordPress?

Present data and evidence: Share data on WordPress's adoption rate, security infrastructure, and the expertise of partners like WP Engine and specialised agencies.
Engage IT and security teams: Involve them early in the decision-making process, address their concerns directly, and demonstrate how WordPress meets security standards.
Emphasise hosting and infrastructure: Highlight the role of managed WordPress hosting providers like WP Engine in ensuring security, performance, and reliability.

Is it easier to upgrade to the latest Drupal version or migrate to WordPress?

Upgrading to the latest Drupal version might seem simpler, but it can involve substantial effort due to significant code changes and underlying technology changes.
Migration complexity can be high regardless of whether you upgrade within Drupal or migrate to a different platform, especially with large amounts of content.
WordPress's iterative approach offers more frequent and gradual updates, minimising disruption and making it easier to maintain the site over time.

How is content migrated from Drupal to WordPress?

Content evaluation: Assess the existing content, identify what needs to be migrated, and determine if any cleansing or restructuring is required.
Data export: Export content from Drupal using tools like the Views Export module to create structured data files.
Data import: Utilise WordPress import plugins like WP All Import to bring the content into the new platform, with potential customisation for complex data structures.
Testing and validation: Thoroughly test the migrated content to ensure accuracy, functionality, and proper display on the new WordPress site.

What is a typical timeframe for a Drupal to WordPress migration project?

Content migration: Typically takes around 4 weeks, depending on the volume and complexity of the content.
Full website rebuild: Including design, development, and content migration, can range from 5 to 12 months, depending on the scope and complexity of the project.
Global multi-site projects: As in Emily's case, can take up to 48 weeks, encompassing research and development, design, build, testing, and launch phases.

Footnotes

Featured image photo by Rafael Garcin.

The Benefits of migrating from Drupal to WordPress: Key Insights from WP Engine's Latest Webinar

Aiden — Fri, 22 Nov 2024 15:28:15 GMT

Last August 2023, the Drupal Association announced the date of 5th January 2025 as Drupal 7's offical End of Life. This means that while individual developers can continue to maintain their sites and modules, Drupal 7 core will no longer receive official support, updates, or maintenance. Site owners, developers and agencies have been assessing their options: do they upgrade to Drupal 8 or find an alternative platform? Neither decision is easy.

WP Engine recently hosted a webinar offering insights from a panel of experts, revealing why enterprises are choosing WordPress over Drupal in 2024. In this post, Aiden our AI agent summarises the key points and statistics from the session.

Watch the Webinar

Speakers

Scott Jones, CEO, Illustrate Digital
Chandan Sharma, Web Development Manager, Bluetext
PeterJohn Hunt, CTO at Useful Group
Emily Averill, Digital Marketing Director at Daniels Health

The Current CMS Landscape

Drupal's Declining Position

According to Scott Jones's presentation, Drupal has experienced a notable decline in usage since 2021, particularly among enterprise brands. A critical factor driving immediate decisions is Drupal 7's impending end-of-life in January 2025, after which security patches and updates will cease.

Webinar slide deck: Drupal's overall decline

WordPress's Market Dominance

The webinar highlighted WordPress's commanding presence among the top 1 million sites by traffic. As PeterJohn noted during the session, "WordPress has done well to really stabilize the amount of changes, and how often those changes are going on... in a way that serves enterprise especially."

Webinar slide deck: Illustrate Digital's recommendation

Key Migration Drivers

Ease of Use and Training

Emily Averill's experience at Daniels Health provided a compelling real-world example. She shared that transitioning to WordPress proved more straightforward than upgrading within the Drupal ecosystem, emphasizing improved team productivity post-migration.

Cost Considerations

The panel discussed several financial advantages:

Lower implementation costs compared to Drupal upgrades
Reduced ongoing maintenance expenses
Better marketing team ROI through improved efficiency

Drupal vs WordPress: Total Cost of Ownership

Cost	Drupal	WordPress
License fee	$0 / year £0 / year	$0 £0
Example build cost	$165,000 - $250,000 £120,000 - £180,000	$100,000 - $200,000 £80,000 - £150,000
Example maintenance cost	$15,000 / year £11,000 / year	$11,500 / year £8,400 / year
Example hosting cost	$5,000 - $10,000 / month £3,500 - £7,000 / month	$5,000 - $7,000 / month £3,500 - £5,000 / month
Example ongoing development cost	$1,500 - $2,000+ / month £1,000 - £1,500+ / month	$1,500 - $2,000+ / month £1,000 - £1,500+ / month

Technical Flexibility

Chandan from Bluetext shared a success story of migrating a complex Drupal site to WordPress within tight deadlines, demonstrating the platform's efficiency and adaptability.

Practical Migration Considerations

Pre-Migration Planning

Based on the panelists' recommendations:

Conduct thorough site mapping and content architecture evaluation
Identify critical content for migration
Plan for both automated and manual content transfer

Stakeholder Engagement

The webinar emphasized involving:

Marketing teams for content strategy
IT and cybersecurity teams for security protocols
Development teams for technical implementation
Content editors for training and workflow adaptation

Security and Maintenance

Security Protocols

Key takeaways from the discussion:

Early involvement of cybersecurity teams is crucial
Address legacy security concerns during migration
Implement robust security measures from day one

Ongoing Maintenance

The panel highlighted WordPress's advantages:

More streamlined update processes
Focus on quality over quantity with plugins
Stronger community support for troubleshooting

Real-World Success Story

The webinar featured Daniels Health's migration journey, where Emily Averill noted: "The culmination of all of that is that it's far easier to do that in the WordPress platform... than it is on the Drupal platform, as was our experience back in the day."

Conclusion

Scott Jones's statement perfectly encapsulates the webinar's message: "WordPress is still the best CMS. It's still trending up, and until it gets really credible competition with something else that's got really high usage, he'll continue to recommend it for both small businesses and enterprises alike."

Ready to start your migration journey? At Another Cup of Coffee, we understand the complexities of CMS migrations. Tell us about your project in the quotation request form for a free assessment. For additional insights, check out our Drupal to WordPress Migration Guide.

Appendix: Key Statistics from the Webinar

1. The Current CMS Landscape

Drupal's Market Position

Approximately 180,000 websites still running on Drupal 7
Drupal 10 has only 75,000 installations currently
Drupal 11 (released in August) has approximately 1,300 installations
Showing significant decline since 2013, with accelerated decline since 2021

WordPress's Dominance

Powers 229,000 of the top 1 million sites by traffic
Controls approximately 41% of all content-managed websites
Powers 34 million websites across the entire internet

2. Critical Timeline Considerations

Version Support Deadlines

Drupal 7 end-of-life: January 2025
Drupal 10's end-of-life: Already set for 2026
Versions 8 and 9 still haven't been as popular as Version 7

Migration Timeframes

Average content migration timeline: 4 weeks
Full project timeline example (Daniels Health): 48 weeks including R&D process
Complete website rebuilds with new design: 5-12 months

3. Technical Migration Considerations

Platform Differences

Drupal 7 to Drupal 10 migration requires complete theme rebuild
Significant architectural changes between versions (PHP files to Twig templates)
Custom modules need complete rewriting for newer Drupal versions

WordPress Migration Benefits

More streamlined update processes
Stronger community support for troubleshooting
More intuitive content management interface

4. Security and Maintenance

End-of-Life Impact

Sites won't automatically go down after end-of-life
Security updates and patches will cease
Sites become increasingly vulnerable to security risks

Footnotes

Aiden is an AI agent and just like a human, it can make mistakes. This summary is posted for convenience but you can verify the statistics by watching the video in full.
Thumbnail photo from the WP Engine Drupal to WordPress Webinar, 12th November 2024.
WP Engine's slide deck for the webinar can be found at From Drupal to WordPress: The Benefits of Migrating Your CMS.

Fixing Access Forbidden (403) issues after migrating WordPress to a static site

Anthony Lopez-Vito — Thu, 09 Feb 2023 01:15:57 GMT

After migrating a WordPress site to static files, Google Search Console may start sending you notifications about page indexing problems. Often the issue will be marked as ‘Blocked due to access forbidden (403)‘, a fairly common error that can have different causes, depending on how your website and server is set up.

This article specifically deals with the case when:

You previously had a working WordPress installation;
You migrate the site to static HTML files on an Apache web server;
Google Search Console starts complaining about page indexing problems.

If this does not apply to your situation, the proposed solution may not work but you will still find the explanation useful in diagnosing the problem.

The Forbidden 403 error

Being in the 4XX category of HTTP response codes, Access Forbidden (403) is a client-side error that may show in a message similar to the following combinations:

Access Forbidden (403)
403 Forbidden
HTTP 403
HTTP Error 403 – Forbidden
Forbidden: You don’t have permission to access [directory path] on this server

The Google Search Console notification email will be about page indexing problems with ‘Blocked due to access forbidden (403)‘ as one of the Top Issues.

A typical Access Forbidden (403) notification from the Google Search Console

Nevertheless, it being a client-side error doesn’t necessary isolate the problem to your browser. Many solutions online will advise you to clear your cache or refresh the page. This is easy to do and usually a sensible first step but if you found the issue via a Google Search Console notification after a WordPress migration, these recommendations won’t help.

The 403 response code essentially means that a web client, such as your browser, does not have permission to access the requested resource. The web server understands the request but can’t allow access due to file permissions settings or a server misconfiguration. When it comes to WordPress, the error will almost certainly be due to a misbehaving plugin, a corrupt .htaccess file or incorrect file permissions. However, if you’ve recently converted your WordPress installation to a static site, the error will most likely have a different cause.

To understand why the Access Forbidden error happens, it’s worth reviewing the differences between how the WordPress content management system (CMS) serves content and how a static site responds to web client requests.

How WordPress serves your browser requests

WordPress is a database-driven Content management system (CMS). Most of the content is stored in a database and URLs generally do not correspond to any files in the web server’s filesystem. Instead, URLs are external references to the database content. WordPress calls these references permalinks and its rewriting engine uses internal rules, specified in the permalink settings, to build permalinks dynamically. When a client requests a page from the site, WordPress takes care of serving the correct content. Included with the pages will be any XML-based RSS (Really Simple Syndication) feeds. WordPress will send the HTML page or an XML feed, depending on what the client requests.

For example, if you set the permalink settings to the Post name structure, WordPress will generate a HTML post when you browse to the following URL:
https://example.com/your-post/

The RSS feed for that post will be at:
https://example.com/your-post/feed/

RSS feeds are normally parsed by an RSS client rather than for displaying directly in the browser window so requesting the RSS feed resource will not send HTML. Instead WordPress will generate XML for the feed.

Serving static files

By definition, static sites have no way of dynamically generating content based on the browser request. You make a request to the web server at a given URL and if the resource is present with the correct access permissions, the web server will go ahead and serve the file. The URL for a static site will normally look something like:
https://example.com/your-post.html.

If you have an RSS feed, it might look something like:
https://example.com/feed.xml.

Notice that the request includes the path to the file, such as your-post.html or feed.xml. The file is not present in a WordPress permalink because, as mentioned previously, it is only a reference to the actual content stored in the database.

Web server directory index

Web servers such as Apache also have a Directory Index directive. This is a configuration that can set the server to automatically send a file when a client makes a request without a filename in the URL. The file known as the directory index and is normally named index.html.

Web servers such as Apache also have a Directory Index directive. In the early days of the web, you could browse to a folder in the web server filesystem and get a listing of all the files present. For security, most web hosts now disable this feature for most of their hosting services. The Directory Index directive is a configuration that can set the server to automatically send a file when a client request only includes the folder name in the URL. For most hosting services, the standard directory index files are normally index.html and index.php.

Say a client makes a request for the following:
https://example.com/docs/

If the directory index is set to index.html, the server would return:
http://example.com/docs/index.html.

The index.html renders as a web page in the browser. Directory index resources can also be set to other file types like index.txt or index.xml.

Generating static HTML files from a WordPress site

WordPress plugins such as Simply Static will crawl your site to generate static HTML file copies for the pages. Since WordPress includes RSS feeds, static XML copies will also be generated for these feeds. The tables below show typical WordPress permalinks and their equivalents after static HTML copies are generated.

Page type	WordPress permalink
Page content	`https://example.com/your-post/`
RSS feed	`https://example.com/your-post/feed/`

Page type	Static file URL
Page content	`https://example.com/your-post/index.html`
RSS feed	`https://example.com/your-post/feed/index.xml`

Once again notice that the static site specifies the filename in the path whereas the WordPress permalink, when set to the Post name structure, does not.

Why access is forbidden

We have all the puzzle pieces to understand why you would get the Access Forbidden (403) error and how you can fix the problem. After you migrate your WordPress site to static files, the old permalink paths to pages will still serve a web page because most hosting providers have index.html as a directory index resource.

You can request the URL in the WordPress post name permalink format:
https://example.com/your-post/

The static file generator would have created an index.html in this location:
https://example.com/your-post/index.html

The webserver sees the index.html in the filesystem and delivers it to the browser which can render the web page content. Human site visitors will be perfectly happy because they receive the web page resources they expect. However, Googlebot, Google’s web page crawler, will spider through your site including the RSS feed locations. Remember, the RSS feed folders will contain an index.xml. XML files are not normally a default directory index resource for most web hosts. Since there is no index.html file in the feed folder, the web server thinks it’s being asked to deliver a file listing. Again remember that file listings are disabled by most web hosts for security. Thus you get the error:

Access Forbidden (403)

You are forbidden by the web server to access that folder listing.

How to fix the Access Forbidden (403) error

Now that we know exactly why we get this error we attempt a fix. If your host runs Apache, the solution will likely be simple. Edit or create the .htaccess file in the root of your site and add index.xml to the list of directory index resources. For example, if it not already there, add the following line somewhere near the top of the file:

DirectoryIndex index.html index.php index.xml

The index.xml in the list will tell Apache to serve the XML file when Googlebot requests the RSS feed directory. While you’re doing this, inspect a few o the feed directories to make sure the index.xml files have the correct permissions (usually 775 for most server setups) and the correct ownership. The ownership settings should be:

user is the user account with root privileges on your web server.
group is usually www-data or apache but you may need to check this with your hosting provider.

You can test your changes by pointing your browser to a few feed directories to see if the server returns XML. Remember to leave out the index.xml file and specify the directory only. For example:
https://example.com/your-post/feed/

If your browser displays the RSS feed XML, you know the problem has been solved and can be reasonably confident that Googlebot won’t encounter the 403 error.

This may not work if you’re running a VPS server for your site where some more in-depth configuration may be needed, such as editing your Apache configuration files. Also, .htaccess is not used by other web servers such as NGINX. In these cases, your next port of call should be to contact your hosting provider. Tell them that you would like to add index.xml to the directory index resources so that the XML file is served when a visitor lands in a directory. Most good hosting companies will be able to guide you on your options or make the change on your behalf. After you’ve applied the fix, be sure to go to your Google Search Console to revalidate the affected page.

Photo by Lucian Alexe on Unsplash

How to set up a MySQL database server on Ubuntu for Drupal to WordPress migrations

Anthony Lopez-Vito — Fri, 11 Jun 2021 15:44:52 GMT

Content Management System (CMS) migration projects involve moving data between databases with different schemas. Table names, field types and constraints often don’t match up, leading to a number of frustrating errors. This is especially the case with highly complex Drupal to WordPress migrations that use custom scripts to extract, transform and load the data. These projects can seem like you’re constantly hitting roadblocks throughout. I’ve found from experience that running the migration in an appropriate development environment can reduce a great deal of effort. In this guide, I will describe how to set up a MySQL database server on Ubuntu for Drupal to WordPress migrations.

Why MySQL and Ubuntu?

The first thing to address is why MySQL and Ubuntu? How about MariaDB? How about Arch Linux, Mac OS or Windows? Yes! Any platform that runs Drupal and WordPress will work for your migration environment so you can use whatever you prefer. Personally, I have a fondness for OpenBSD but it’s not a practical platform for a CMS migration. OpenBSD’s niche user-base means you’ll spend much longer installing necessary tools and troubleshooting errors.

There are all sorts of tutorials covering MySQL on Ubuntu. This means you’re more likely to quickly find a solution from a web search when you hit a problem. Furthermore, if you need a software utility or program to help you get the job done, it will probably be available through apt, dpkg, snap or tasksel. Use whatever you like but for now, MySQL on Ubuntu is my recommended platform for Drupal to WordPress migrations. I expect this will be the case for some time to come. These projects are complex and time-consuming enough without making the job more difficult.

Installing MySQL on Ubuntu for CMS migrations

There are many detailed tutorials for installing MySQL on Ubuntu. DigitalOcean’s How To Install MySQL on Ubuntu 20.04 is a good one and writing another won’t add much value. My guide will therefore only give a brief overview of the MySQL server installation steps. Instead, I will focus on the configuration areas specifically related avoiding problems on a CMS migration project.

You may wonder why the migration environment should be much different from a live server. Migration projects require you to do things that aren’t supported by the CMS platform. You’re therefore likely to encounter weird errors that aren’t normally found when running standard Drupal or WordPress.

Set up your Ubuntu LAMP migration platform

The main source of unusual errors is almost certainly because you’re migrating on a setup suited to a live website. Live server configurations are more restrictive than you need for a migration project. You can therefore save yourself a huge headache by rolling your own local migration environment. It might take a little longer to get started but you’ll save time by avoiding lots of unnecessary troubleshooting.

I must highlight that this will be a local migration environment and should not be accessible from the public internet. The normal security considerations with running a live content management system don’t apply when you’re working locally. By all means follow basic security measures mentioned the various tutorials for setting up Ubuntu and MySQL. Nevertheless, a highly secure setup is counterproductive for these projects and you can avoid trouble by being a little more permissive.

Go ahead and install Ubuntu Desktop. Since this will be a development environment, you’ll want the Desktop environment rather than the more lightweight server version. Of course, you’ll still need to install a web and database server. Follow these instructions for installing LAMP stack but skip the step of installing MariaDB. As mentioned above, we’ll be using MySQL.

WARNING: Installing MariaDB over MySQL or vice versa on Ubuntu 20.04 may lead to all sorts of problems starting up the database server with errors like the following:

Failed to start mysqld.service: Unit mysqld.service not found.

The last time I did this, none of solutions mentioned online for purging the installation worked. I spent most of a day trying to fix the problem. In the end, I realised it was quicker to start again and rebuild the machine from scratch. This is a big reason why I decided to stick with MySQL as standard for my projects.

Install MySQL

You can read a more detailed tutorial on installing MySQL on Ubuntu but here’s an overview.

Update the package index on your server: sudo apt update
Install MySQL server: sudo apt install mysql-server
Secure MySQL: sudo /usr/bin/mysql_secure_installation

The mysql_secure_installation script doesn’t cause problems for migrations so it’s worth running.

Create an admin user:

CREATE USER ‘user’@'localhost’ IDENTIFIED BY ‘userpassword’;
GRANT ALL PRIVILEGES ON *.* to ‘user’@'localhost’ WITH GRANT OPTION;
FLUSH PRIVILEGES;
quit;

Now create a user and database for your migration project:

CREATE USER ‘projectuser’@'localhost’ IDENTIFIED BY ‘password’;

CREATE DATABASE project_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci;
GRANT ALL ON project_db.* TO ‘projectuser’@'localhost’;

You can give this user more restrictive permissions but GRANT ALL avoids errors when running scripts and SQL queries on the database. Only the migration team should have access and you won’t need it after the migration so why not make your life easier?

Setting the MySQL server SQL mode

It’s possible that you won’t be familiar with SQL modes unless you’ve done some database administration work. For our purposes, SQL modes do two things:

change the types of queries you can run on your MySQL server;
change the validation checks when altering the data.

I’ve found that specific SQL modes need to be set for Drupal to WordPress projects. You may find that all sorts of strange errors appear if the correct modes aren’t set. The following sections show you two ways to set your MySQL server’s SQL mode.

Option 1: Setting the global sql_mode in the database

Login in to database as an admin user.
View the current sql-modes using SELECT @@GLOBAL.sql_mode; and make a copy if necessary.
Copy the current modes (add or delete modes as needed) and paste in next step.
Add ALLOW_INVALID_DATES and removes both NO_ZERO_DATE, NO_ZERO_IN_DATE by setting the sql-modes with
SET GLOBAL sql_mode = ‘STRICT_TRANS_TABLES,ALLOW_INVALID_DATES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION’; (WARNING: check the modes correspond with your setup.)
Restart server:
sudo systemctl start mysql

Option 2: setting the sql_mode in the MySQL configuration file

Locating the MySQL configuration file

The my.cnf configuration file isn’t always found in the same place. It’s specific to the Linux distribution and server configuration but can normally found in one of the following locations:

/etc/my.cnf
/etc/mysql/my.cnf
echo/my.cnf
[datadir]/my.cnf
~/.my.cnf

If you can’t find your MySQL configuration file, you can try running locate my.cnf or mysqladmin –help. The latter will show something like the following in the output:

Default options are read from the following files in the given order:
/etc/my.cnf /etc/mysql/my.cnf ~/.my.cnf

Also keep in mind that it’s possible to use !include directives to include other option files and !includedir to search specific directories for option files. Under Ubuntu, there may be a file /etc/mysql/my.cnf with !includedir directives to search /etc/mysql/conf.d/ and /etc/mysql/mysql.conf.d/

Editing the MySQL configuration file

If the MySQL server finds more than one configuration file, it will load each one in turn. The values override each other and it can be difficult to know which takes priority. Furthermore, the –defaults-file parameter can also override all configurations. Keep things simple and have only one file and place it the directory that makes sense to you.

Before editing the my.cnf, first log in to MySQL with an administrator user and run the SELECT @@GLOBAL.sql_mode query to see the values used in your setup.

Running the SELECT @@GLOBAL.sql_mode query on MySQL Workbench

Next, open the configuration file, look for the section [mysqld] and edit the line starting with:
sql_mode = …

Add the line if it’s not there. Adjust the exact modes to match your project’s needs so take a look at the list of SQL modes to see which may apply. I’ve found the following works well:
sql_mode = “STRICT_TRANS_TABLES,ALLOW_INVALID_DATES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION”

Finally, restart the MySQL server. On Ubuntu this will probably be with

sudo systemctl start mysql

If you are logged in to the MySQL server, you may also need to disconnect your client and reconnect for the changes to take effect for your session.

Potential errors

Here are some potential errors that you may come across during a CMS migration project. I usually find them when running a Drupal to WordPress migration on a freshly built development environment.

mysqldump access denied when trying to dump tablespaces

Migrations involve dumping and importing databases and this process is straightforward on a mature development environment. However you may receive an ‘Access denied’ error out of the blue when dumping your MySQL database:

mysqldump: Error: ‘Access denied; you need (at least one of) the PROCESS privilege(s) for this operation’ when trying to dump tablespaces

If you see this, perhaps you were working on an environment that was a little too ‘mature’ (in other words, obsolete!) and you have recently upgraded your installation. The updates for MySQL 5.7.31 and MySQL 8.0.21 in July 2020 introduced an incompatible change that produces this error.

Read my separate article, How to fix the mysqldump access denied process privilege error, for more information and instructions on how you can try solving this.

ERROR 1067 (42000) Invalid default value

Drupal nodes store the date as a Unix timestamp in an int (e.g. 1623427200) field whereas WordPress stores dates as datetime (e.g. 2021-06-11 16:00:00). There may be a conversion error in your migration script or the source date could simply be zero for some reason. Normally your MySQL server mode will be set to NO_ZERO_DATE, NO_ZERO_IN_DATE so trying to insert a zero date will give you the error:

ERROR 1067 (42000) Invalid default value

You can fix this by replacing NO_ZERO_DATE, NO_ZERO_IN_DATE with set to ALLOW_INVALID_DATES in your global SQL mode.

Expression #1 of SELECT list is not in GROUP BY clause

You run an SQL query and get the rather cryptic error:

Expression #1 of SELECT list is not in GROUP BY clause and contains
nonaggregated column ‘database.table.pid’ which is not functionally dependent
on columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by

What’s wrong? MySQL has a only_full_group_by mode which, when enabled, strictly applies ANSI SQL rules when using GROUP BY. Fix this by reworking your script or removing the ONLY_FULL_GROUP_BY SQL mode.

Error Code: 2013. Lost connection to MySQL server

This often happens when it an SQL query takes too long to return data. The connection between your MySQL client and database server times out so the connection gets dropped. For ideas on how to try solving this, read my separate article, How to fix Error Code 2013 Lost connection to MySQL server.

Conclusion

Setting up a MySQL database server for Drupal or WordPress is a familiar task for web developers and site administrators. However, CMS migrations have quirks that can cause obscure and baffling errors. In this guide I’ve shown you some little tricks that may save time and annoyance. While there’s no way to provide an exhaustive list of solutions to all the MySQL problems you’ll encounter, I hope to have pointed you in the right direction.

If you have a site migration project and would like to hire me, please ask for a quote for my consulting service.

CMS migration consulting

All content · Custom content types · SEO · Plugins

Migrating content from a site and need a specialist? Please contact me for a quotation. Whether you’re a media agency who needs a database expert or a site owner looking for advice, I’ll save you time and ensure accurate content exports.

Cover photo by Rubaitul Azad on Unsplash

A guide to WordPress Backups and Staging

Anthony Lopez-Vito — Tue, 11 Feb 2020 12:59:11 GMT

This WordPress Backups and Staging Guide is a guest post by Melinda Bartley.

If you’ve run a WordPress site long enough, you’d know how making changes to it can be tricky. Sometimes, even minor changes can cause major glitches. This makes backups and staging such lifesavers!

Every WordPress site should have backup and staging solutions in place. And not just any solution, one that actually works! I say this because in my experience, relying on host backups and staging environments have too many limitations and a tedious process. So I turned to plugins, but there too, I found so many options, it was hard to pick the right one.

In my quest to get a permanent solution, I stumbled upon BlogVault. It was easy-to-use and reliable with a great support team behind it. Ever since, it has been my go-to for WordPress backups and staging.

So today, I’m sharing everything what I think WordPress site owners should know about backups and staging and why BlogVault works best.

Let’s begin with a few basics.

Difference Between Backup and Staging

Many ask If I have a backup, why do I need staging? Well, the two solve very different problems. Backups are for reverting to a previous version when a problem arises on the site.

For example, you run an update on your website and it causes your site to malfunction. You find that plugins are not compatible with the new version of WordPress. It would take considerable time to update these plugins or find replacements. To solve the issue immediately and get your site back to normal, you can restore your backup.

Backups come in handy when things go wrong such as botched updates, human errors, presence of malware, and so on.

Coming to staging, it enables you to create a clone of your WordPress website. This is done specifically for development. You can try out new themes, plugins, designs and layouts. You can test out updates and even test restore your backup! None of the changes you make will affect your live site.

There are staging solutions that have a feature to merge your changes. This is extremely handy because you might make multiple changes and it would take time to replicate the same on your live site. So you can just push the changes to your live site. Simply put, staging enables progress!

Now that you know why you need both solutions, let’s check out the backup solutions available for WordPress sites.

WordPress Backup Solutions

There are many options to backup your WordPress site, but not all of them are easy to use or reliable. The main options available to back up your site are – manually, using a plugin, or through your web host.

Manual Backups

For this, you need to access your web hosting account. Once you’ve logged in, go to cPanel > File Manager > Public_Html. Here, you’ll see all your WordPress files. Simply compress and download them.

(Image source: WP Engine)

It seems simple enough. But there are issues with this method. For one, the process is time-consuming. Spending time taking manual backups regularly is simply not feasible when you have tons of other things to focus on. Plus, you need to take responsibility to encrypt your data and store the backup locally. A backup has all the information on your website and needs to be stored securely. If hackers get their hands on an unencrypted backup, it’s already a data breach, but you can be sure your site will be hacked as well.

But above all, the biggest hassle with this method is the restoration process. Sometimes, the backup just doesn’t work at all. Other times, you restore your site only to find it malfunctioning or missing functionalities. Which means more time wasted on troubleshooting and debugging troubles. This is why I prefer using a plugin. But among these too, there are so many options available, how do you choose one?

Well, after trying out a couple of them, I stuck with BlogVault. It’s great for backups and even offers inbuilt staging at no additional cost.

Backups with a WordPress Plugin – BlogVault

To start off, setting up BlogVault was easy to use – with a simple install and activate process. Once you sign up, the backup automatically runs. It gives you the following options which I think is not only cool but essential for WordPress:

- The option to schedule your backups. Plus, you can take a backup on demand whenever you want, any number of times. This is good to have when you want to make major changes to your site or roll out big updates. Taking a backup before any major change is absolutely necessary.
- It’s all automated so you don’t have to worry about the technicalities.
- The restore process is just a few clicks. It takes a few minutes and it’s guaranteed to work. So you needn’t worry about your site breaking or losing data.
- The process is handled offsite on their own servers so it doesn’t affect the performance or speed of your site. Plus, it doesn’t take a full backup every single time. It smartly copies one full backup and then subsequently, only the changes made each time are backed up.
- Lastly, your backup is encrypted and multiple copies of it are stored securely. That takes away the pain of storage.

Apart from this, there are handy features like 365-day archives, real-time backups, website management, site migrations, multiple site management, uptime monitoring, and staging.

Next, you can also back up your website using your web host itself. I’ve checked out two of the most popular ones.

Backups with your Host – WP Engine

WP Engine takes backups for all environments by default. This includes production staging, development, and legacy staging. It’s automated, encrypted, and stored offsite on Amazon S3. You can also take manual backups. It keeps up to 40 backup points. Older data up to 60 points may be accessible but you need to contact their support team for that.

To access a backup, log into your user portal. Go to sites > environment name > backup points. You’ll find your backups here. You can also create a backup on demand.

To restore, simply click on the backup point you want and click the Restore button.

(Image source: WP Engine)

The process seems simple enough. But WP Engine also has some drawbacks. The restore process can take several minutes to several hours. And it’s important to note that they do not copy all files of your site. The following files aren’t included:

Additionally, it’s a destructive backup which means, during the restoration process, all content is overwritten. So, if you have files on your website that are not present in your backup, they will be wiped out. Your site will be restored to the contents of the backup alone.

Backups with your Host – Kinsta

Kinsta provides daily automatic backups for your WordPress site. It also has system-generated backups for all the sites listed in your account. The backup is a snapshot of your website’s files, database, redirects, and Nginx configuration. When you restore your backup up, all of these elements will be rolled back to when the backup was taken.

You can also create manual backups if you want one immediately and don’t want to wait for the scheduled one to run. You need to visit the ‘Backups’ tab, click on the ‘Manual’ tab. Here, you’ll find the ‘Backup Now’ button for on-demand backups.

(Image source: Kinsta)

The duration for which your backups are stored depends on your hosting plan. It can vary between 14 days and 30 days. Kinsta also allows you to increase the frequency of your backups to hourly and 6-hour backups at a premium.

When it comes to restoring your site, you can simply click on the ‘Restore’ button next to the backup of your choice. While the restore takes place, you cannot access your site. The process can take a few minutes to a few hours.

What I liked about Kinsta is that it takes a backup of your site before restoration. So you can undo the restore and get back your site to as it was.

That brings up to the end of backups. With a backup solution in place, we can move on to staging. Here, I’ll touch upon – the manual method, show you how you can do this with the BlogVault plugin, and also talk about staging with your hosting provider.

WordPress Staging Solutions

Staging a site can be done manually through your hosting account. But it’s riddled with problems. The process to create one is quite technical, and for a regular WordPress user, it’s not a feasible option.

Next, if you want to merge the changes you made, you need to download the updated files from your staging site and upload them to you live site. This is risky business as you could wipe out data and even crash your site.

Fortunately, there are other options! You can create a staging site with your host or by using a plugin. Coming back to BlogVault, it also offers a staging feature that makes the job much easier.

Staging with BlogVault

If you’ve already installed BlogVault, staging is a free feature compatible with any web host. On the BlogVault dashboard, you’ll see an option to ‘Add staging site’. It takes a few minutes, and you’ll be notified when it’s done.

(Image source – BlogVault)

The plugin handles migrating your site to a dev environment, so you don’t have to bother about the file transfer and the database export and import. The staging site is password protected and blocked off from search engines so migration does not affect your SEO.

With everything taken care of, you simply need to start using your staging site. Once you’re happy with the changes you’ve made, you can simply merge the changes to your live site. There’s no need to upload files or replicate changes.

(Image source – BlogVault)

You can also do a selective merge. BlogVault gives you a comparison of your live site and your staging site. You can then select which changes you want to merge to your live site. In the example below, I made changes to my plugins, themes, uploads, and a few other files. But I wanted only the changes made to plugins. By clicking on the ‘+’ sign, I could see the list of plugins I added or modified. I selected the ones I wanted and merged in just two clicks.

(Image source – BlogVault)

The best part is that you can create as many staging sites as you want. So that’s BlogVault. It’s straightforward and easy to use. It won’t break your site when you merge the changes so your site is in safe hands.

Next, let’s take a look at staging options with web hosting providers.

Staging with WP Engine

WP Engine gives you options to create three kinds of environments – production, staging, and development.

To carry out the staging process, you first need to add your site to the user portal. Next, log into the user portal and access Sites > Name of your site > Add staging. Your staging site will be created using the backup point of the existing environment.

(Image source – BlogVault)

In case you don’t see the staging option, you need to convert a single environment site into a multi-environment site.

Once you’ve made the changes you want, you can copy the changes from staging to your production environment.

WP Engine also allows you to copy changes from a staging environment of one site to another website. This means you can roll out updates or changes to all your sites without repeating the staging process for each site. However, this can get a bit complicated and isn’t recommended for those new to WordPress.

Staging with Kinsta

Creating a staging site with Kinsta is quite easy. Access your Kinsta dashboard and select your site. Here, on the top right, you have the option to create a staging environment for your website. It takes around 10-15 minutes to create a staging site.

Once you refresh the page, you will see your staging details. You can make the changes you like to your staging site and then push them to your production environment. To do this, under the ‘Staging Environment’ tab, there’s a ‘Push Staging to Live’ button. Simply click on it and all the changes will be made visible on your live site.

There’s no selective merge option here. So if you’re pushing changes to live, be aware that all changes will be merged.

Final Thoughts

That’s a wrap on backups and staging for your WordPress site. To summarize, hosts may offer free versions of backup and staging, but you’re limited in terms of features and functionality. As your site grows bigger, you would need to upgrade to premium plans which are quite expensive. However, when you opt for a plugin like BlogVault, it’s reasonably priced, gives you access to premium features, and above all, it works seamlessly.

Whichever be your choice, make sure you can rely on your backup to work and be restored easily. Finally, always carry out changes in a staging environment before updating your live site. This will keep you out of trouble and ensure your site is always up and running.

Ubercart to WooCommerce migration notes

Anthony Lopez-Vito — Fri, 24 Jan 2020 12:14:07 GMT

I've now had several Ubercart to WooCommerce migration projects so it's time to start documenting the process. As with all my documentation, I'll start off this post as rough notes and improve it over time. If this topic interests you, be sure to check back every so often to see the updates. Please keep in mind that I'm writing this from the standpoint of Drupal to WordPress migrations. In other words, the main objective for the projects were to migrate a Drupal site to WordPress but there was also an Ubercart to WooCommerce component.

Key differences between Ubercart and WooCommerce

There's one key difference between Ubercart and WooCommerce from an architectural point-of-view. Ubercart stores products as nodes and orders are stored in a separate table uc_orders. Orders have an order_id and there's no direct relationship in uc_orders to a product's node ID. Instead, the uc_order_products table stores the relationship between orders and products purchased with the order.

WooCommerce stores both products and order transactions as posts in the wp_posts table. The post ID is used as the order's transaction ID. Products purchased with the order are stored in wp_woocommerce_order_items, with additional product metadata being strored in wp_woocommerce_order_itemmeta.

Obviously there are many more differences but this information architecture is the key thing to keep in mind when migrating the data.

Database tables

Here are the main database tables that you'll need to migrate Ubercart content to WooCommerce.

Ubercart

Table: Drupal Ubercart tables
Table	Description
node	Products are stored in the Drupal `node` table.
uc_orders	Stores the individual Ubercart transactions.
uc_order_products	Stores the products purchased during the transaction.
uc_order_line_items	Line items for an order. This includes tax and shipping fees applied to an order.
uc_order_comments	Customer or administrator notes associated with each order.
uc_order_log	Comments about the order status by the shop administrator.
uc_zone	Country zone codes for customer billing and delivery.
uc_countries	Countries and zone codes in ISO 3166-1 Alpha-2 and Alpha-3 code format for customer billing and delivery.

WooCommerce

Table: WordPress WooCommerce tables
Table	Description
wp_posts	Stores products and transactions.
wp_postmeta	Transaction meta data.
wp_woocommerce_order_items	Stores the line items for a transaction in the `wp_posts` table.
wp_woocommerce_order_itemmeta	Stores the meta data for line items, such as quantity, price and tax information.
wp_comments	Order notes.

Order transactions and products are saved as WordPress posts. One or many order item meta entries can be linked to an order.

WooCommerce shop orders

A WooCommerce transaction is saved as a shop order in the wp_posts table.

post_status = wc_completed
post_type = shop_order

WooCommerce subscriptions

WooCommerce subscriptions are saved in wp_posts. A subscription is made up of two entries:

The transaction order for a subscription.
The subscription itself.

Subscription transaction order

post_status = wc_completed
post_parent = 0
post_type = shop_order

The subscription

post_status = wc_active
post_parent = [post ID to the transaction shop order]
post_type = shop_subscription

Products

Purchased products are saved as line items in the wp_woocommerce_order_items and wp_woocommerce_order_itemmeta tables.

A WooCommerce product can be of any post type. The product post is linked to a shop order transaction by setting the product's post ID in the wp_woocommerce_order_itemmeta table:

meta_key = _product_id
meta_value = [post ID to the product]

Notes

My apologies if you've come here looking for more complete documentation. I've been planning to write this post for more than two years but have been putting it off due to my work schedule. I figure the best way to finally get it done is to just make a start and update it as time allows.

The most-viewed articles here started off as notes for my own use and evolved over time. This one is no different. Hopefully it will still be of use to some people in its draft state.

In the meantime, you might want to take a look at these other articles and plugins.

How to fix Error Code 2013 Lost connection to MySQL server

Anthony Lopez-Vito — Sat, 15 Jul 2017 19:08:23 GMT

If you spend time running lots of MySQL queries, you might come across the Error Code: 2013. Lost connection to MySQL server during query. This article offers some suggestions on how to avoid or fix the problem.

Why this happens

This error appears when the connection between your MySQL client and database server times out. Essentially, it took too long for the query to return data so the connection gets dropped.

Most of my work involves content migrations. These projects usually involve running complex MySQL queries that take a long time to complete. I’ve found the WordPress wp_postmeta table especially troublesome because a site with tens of thousands of posts can easily have several hundred thousand postmeta entries. Joins of large datasets from these types of tables can be especially intensive.

Avoid the problem by refining your queries

In many cases, you can avoid the problem entirely by refining your SQL queries. For example, instead of joining all the contents of two very large tables, try filtering out the records you don’t need. Where possible, try reducing the number of joins in a single query. This should have the added benefit of making your query easier to read. For my purposes, I’ve found that denormalizing content into working tables can improve the read performance. This avoids time-outs.

Re-writing the queries isn’t always option so you can try the following server-side and client-side workarounds.

Server-side solution

If you’re an administrator for your MySQL server, try changing some values. The MySQL documentation suggests increasing the net_read_timeout or connect_timeout values on the server.

Client-side solution

You can increase your MySQL client’s timeout values if you don’t have administrator access to the MySQL server.

MySQL Workbench

You can edit the SQL Editor preferences in MySQL Workbench:

In the application menu, select Edit > Preferences > SQL Editor.
Look for the MySQL Session section and increase the DBMS connection read time out value.
Save the settings, quite MySQL Workbench and reopen the connection.

Navicat

How to edit Navicat preferences:

Control-click on a connection item and select Connection Properties > Edit Connection.
Select the Advanced tab and increase the Socket Timeout value.

Command line

On the command line, use the connect_timeout variable.

Python script

If you’re running a query from a Python script, use the connection argument:
con.query(‘SET GLOBAL connect_timeout=6000′)

Post-migration troubleshooting: Gateway timeout when enabling plugins

Anthony Lopez-Vito — Mon, 05 Jun 2017 09:35:07 GMT

Here's one that caught me out on a recent Drupal to WordPress migration. As is common with my projects, there were three parties involved: the client, an external development team and myself. The WordPress site was first built on the development team's server, after which it was migrated to my local environment. When everything was ready for beta testing, we moved the site over to the client's staging server on a newly activated account over at Kinsta. Eventually, we'd move it over to a live server, also hosted on Kinsta.

After some initial tests on staging, I found that deactivating and reactivating plugins would cause the site to hang and show a '504 Gateway Time-out' error. This happened when re-enabling some but not all plugins.

I initially suspected some misconfiguration at the hosting end because there were some hitches with the newly create account. At the outset, the account's server had an issue which Kinsta support needed to fix. For convenience, we'd also made use of Kinsta's free site migration service. This is where they'll migrate an existing WordPress site into their environment. Though it would have been easy enough for me to do, we thought to give it a try. In hindsight, this was a bit of a mistake. The site migration service itself was fine but it did end up causing some confusion. First, a miscommunication in the migration request caused them to create a temporary domain we didn't want. They helpfully solved this by giving us a second temporary domain. However, they'd also upgraded everything to PHP 7 in the process. All of these issues were possible suspects for the time-out error but turned out to be red-herrings.

It took some time to pinpoint the cause behind the Gateway Time-out error. I do have to say that Kinsta support were very responsive throughout the troubleshooting process. They eventually put a senior engineer on the case who found the problem. It turned out the problem wasn't to do with Kinsta at all. There was a leftover setting from the original development team's server. It was a valid format so didn't cause an issue on either my local server or my staging server. However, it apparently can cause issues with plugins and did on the Kinsta environment.

What was the setting? The WordPress upload path directory was set to the development team's server path e.g. /home/dev/public_html/sitename. Throughout the migration, I'd been doing a database search-and-replace looking for their development domain. Somehow, as the site moved from different servers, that server path string remained in the database, only to cause a problem when the site landed in the destination server on Kinsta.

I'm not sure if there would have been any way to have caught this problem earlier. It's one of those obscure errors that are easy to overlook and take time to resolve. There's also no practical way to do a database search-and-replace for every imaginable string. I'll have to rack this one up to experience.

How to change the WordPress table prefix prior to a migration

Anthony Lopez-Vito — Thu, 16 Mar 2017 13:12:02 GMT

When working on a Drupal to WordPress migration project, I like to migrate into a set of intermediary WordPress tables that live in the Drupal database. These are working tables where I can run various scripts to process and clean up the content before exporting to a working WordPress installation. It’s not necessary to do this but I find it convenient to run scripts on the same database rather than deal with two separate database connections.

Note that some people suggest renaming the table prefixes to improve security. My use of the table prefixes is simply to create temporary containers for the migration. While non-standard prefixes might help prevent ‘script kiddie’ attacks, I find it isn’t worth the disadvantages that come with this sort of security through obscurity (or more precisely, security through minority) approach. Here are two articles give a deeper explanation of topic:

wordfence.com: WordPress Table Prefix: Changing It Does Nothing to Improve Security
wpkrauts.com: The database table prefix is not a security feature

SQL queries to change the WordPress table prefixes

You can start with a freshly installed WordPress database. Dumping this and importing to your Drupal migration database will give you all the tables with the correct WordPress schema. I use the acc_ prefix but you can use whatever you want.

Rename the tables with these queries:

RENAME table `wp_commentmeta` TO `acc_commentmeta`;
RENAME table `wp_comments` TO `acc_comments`;
RENAME table `wp_links` TO `acc_links`;
RENAME table `wp_options` TO `acc_options`;
RENAME table `wp_postmeta` TO `acc_postmeta`;
RENAME table `wp_posts` TO `acc_posts`;
RENAME table `wp_terms` TO `acc_terms`;
RENAME table `wp_termmeta` TO `acc_termmeta`;
RENAME table `wp_term_relationships` TO `acc_term_relationships`;
RENAME table `wp_term_taxonomy` TO `acc_term_taxonomy`;
RENAME table `wp_usermeta` TO `acc_usermeta`;
RENAME table `wp_users` TO `acc_users`;

Testing the migration results

If you need to point a WordPress installation to these tables for testing, you’ll need to do two things:

Update the $table_prefix setting in the wp-options.php file
Update the options and usermeta tables

Updating the $table_prefix setting in the wp-options.php file is straightforward. Open the file and edit the line:

$table_prefix  = ‘acc_’;

In WordPress, prefixes are saved as entries in the options and usermeta table. Check for entries containing the prefix:

SELECT * FROM `acc_options` WHERE `option_name` LIKE ‘%wp_%’;
SELECT * FROM `acc_usermeta` WHERE `meta_key` LIKE ‘%wp_%’;

When you have all the entries, update them with the new prefix. The query will probably look something like this:

UPDATE `acc_options` SET `option_name` = ‘acc_user_roles’ WHERE `option_name` = ‘wp_user_roles’;
UPDATE `acc_usermeta` SET `meta_key` = ‘acc_capabilities’ WHERE `meta_key` = ‘wp_capabilities’;
UPDATE `acc_usermeta` SET `meta_key` = ‘acc_user_level’ WHERE `meta_key` = ‘wp_user_level’;
UPDATE `acc_usermeta` SET `meta_key` = ‘acc_user-settings-time’ WHERE `meta_key` = ‘wp_user-settings-time’;
UPDATE `acc_usermeta` SET `meta_key` = ‘acc_user-settings’ WHERE `meta_key` = ‘wp_user-settings’;
UPDATE `acc_usermeta` SET `meta_key` = ‘acc_dashboard_quick_press_last_post_id’ WHERE `meta_key` = ‘wp_dashboard_quick_press_last_post_id’;

A word of warning: it’s easy to forget to change the prefixes back to match the final WordPress installation. If you do, the WordPress user accounts will have problems, such as the Dashboard controls not being visible after logging in. Because of this, I tend to have a separate testing installation that gets an import of the working tables.

Cover photo by Gavin Allanwood on Unsplash

Migrating Bare Bones Yojimbo to WordPress

Anthony Lopez-Vito — Wed, 04 Jan 2017 11:28:07 GMT

In a previous post, I wrote about exporting data from Bare Bones Software's Yojimbo and using Tomboy as an alternative. My migration script scraped the content from Yojimbo Sidekick and wrote XML files in Tomboy Note format. Though there were some drawbacks, such as tags being unavailable in Yojimbo Sidekick, I thought Tomboy's search feature would be adequate. A couple of weeks trialling Tomboy proved that it wasn't going to be a Yojimbo killer. Tomboy can't compete in terms of overall usability and though it'll work on my Linux and OS X machines, note synchronisation takes some setup that didn't warrant further time investment.

Once again I turned to WordPress as an easy solution. There's a risk of seeing WordPress as my hammer for everything that looks like a nail but it has taxonomies, a reliable-enough search functionality and being web-based, works across all my devices. I'm very familiar with the platform and have already built up my own set of tools to export and migrate content. Why not use WordPress? Getting data out of Yojimbo was another issue. The quick and easy Yojimbo Sidekick route already proved inadequate so it was time to dig in and reverse engineer Yojimbo's storage mechanism.

Analysing and exporting the Yojimbo database

'Reverse engineering' turned out to be too lofty a term for the task. It was obvious after quick look that Yojimbo uses an SQLite database to store information. Firing up DB4S to analyse the tables and bit of analysis revealed the tables, columns and relationships that are important for exporting our notes. The columns are a little oddly named but it didn't take long to figure out the necessary fields for migrating to WordPress.

Table: ZITEM
Column	Description
ZBLOB	This looks like an ID
ZNAME	The Yojimbo note title
Z_PK	The ID to the Z_15TAGS relationship table

Table: ZTAG
Column	Description
Z_PK	The Tag ID
ZNAME	The tag name

Table: ZBLOBLSTRINGREP
Column	Description
ZBLOB	ID
ZSTRING	String for unencrypted item

Table: Z_15TAGS
Column	Description
Z_15ITEMS1	Relationship ID
Z_25ITAGS	Tag ID

It became a simple matter of tweaking my Drupal to WordPress migration queries to extract from the Yojimbo database and create WordPress posts. Unlike with the Tomboy Notes route, it was possible to recreate the tags, which is what makes Yojimbo so useful. One drawback is that I haven't figured out how to extract encrypted notes but I didn't use Yojimbo to store important encrypted information so that wasn't a priority.

WordPress as a Yojimbo alternative

Using WordPress as a Yojimbo alternative might not work for everyone but after several months use, I've found it to be an excellent cross-platform replacement. The installation and database runs on a NAS drive connected to my local network so is accessible to all my devices. Standard WordPress taxonomies, search and plugins makes content management simple once you've imported the Yojimbo content. In fact, by migrating away from Yojimo, I've ended up creating my own full-blown personal knowledge management system.

If you need to export your Yojimbo notes to a cross-platform alternative, give WordPress a try. You can grab my migration script from GitLab but please keep in mind that it was a quick hack to achieve a specific one-time objective. You may need to hack it to suit your own setup.

Focus on your mission, not your tech - Another Cup of Coffee (Posts about WordPress)

Drupal 7 End of Life: Why WordPress is the Best Migration Option for Lower Maintenance Sites

Final Deadline Announced After Multiple Extensions

What Happens If You Stay on Drupal 7?

Why Choose WordPress Over Upgrading Drupal?

Is it Worth Upgrading Drupal?

Real-World Success Stories

How We Handle Migrations at Another Cup of Coffee

Our Process:

Why WordPress is the Smarter Choice Today

Let's Talk

Drupal 7 End of Life Frequently Asked Questions

Footnotes

You may also like

The Benefits of migrating from Drupal to WordPress: Key Insights from WP Engine's Latest Webinar

Table of Contents

Watch the Webinar

Speakers

The Current CMS Landscape

Drupal's Declining Position

WordPress's Market Dominance

Key Migration Drivers

Ease of Use and Training

Cost Considerations

Drupal vs WordPress: Total Cost of Ownership

Technical Flexibility

Practical Migration Considerations

Pre-Migration Planning

Stakeholder Engagement

Security and Maintenance

Security Protocols

Ongoing Maintenance

Real-World Success Story

Conclusion

Appendix: Key Statistics from the Webinar

1. The Current CMS Landscape

Drupal's Market Position

WordPress's Dominance

2. Critical Timeline Considerations

Version Support Deadlines

Migration Timeframes

3. Technical Migration Considerations

Platform Differences

WordPress Migration Benefits

4. Security and Maintenance

End-of-Life Impact

Footnotes

You may also like

Fixing Access Forbidden (403) issues after migrating WordPress to a static site

Table of contents

The Forbidden 403 error

How WordPress serves your browser requests

Serving static files

Web server directory index

Generating static HTML files from a WordPress site

Why access is forbidden

How to fix the Access Forbidden (403) error

You may also like

How to set up a MySQL database server on Ubuntu for Drupal to WordPress migrations

Table of contents

Why MySQL and Ubuntu?

Installing MySQL on Ubuntu for CMS migrations

Set up your Ubuntu LAMP migration platform

Install MySQL

Setting the MySQL server SQL mode

Option 1: Setting the global sql_mode in the database

Option 2: setting the sql_mode in the MySQL configuration file

Locating the MySQL configuration file

Editing the MySQL configuration file

Potential errors

mysqldump access denied when trying to dump tablespaces

ERROR 1067 (42000) Invalid default value

Expression #1 of SELECT list is not in GROUP BY clause

Error Code: 2013. Lost connection to MySQL server

Conclusion

You may also like

A guide to WordPress Backups and Staging

Difference Between Backup and Staging

WordPress Backup Solutions

Manual Backups