jetpack-markdown

I use the jetpack-markdown WordPress plugin to write my weblog posts in Markdown. Although jetpack-markdown is no longer maintained, it was still available to download using wp-cli. Whilst doing some maintenance on reyhan.org, I discovered this is no longer the case1:

wp plugin install jetpack-markdown --activate
Warning: jetpack-markdown: Plugin not found.
Error: No plugins installed.

With little inclination to research a replacement, I went looking for the source code and was thankful that it’s still online. In addition, the latest version still seems to be available to download2:

wp plugin install https://downloads.wordpress.org/plugin/jetpack-markdown.3.9.6.zip
Downloading installation package from https://downloads.wordpress.org/plugin/jetpack-markdown.3.9.6.zip...                                                   
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating 'jetpack-markdown'...
Plugin 'jetpack-markdown' activated.

  1. From the plugin description: This plugin was closed on April 28, 2019 and is no longer available for download. 
  2. Though who knows how long for? I downloaded the zip and added it to my build process for future use. 

Migrating to WordPress: A brief retrospective

Last year I took the step to migrate content from a Jekyll-powered weblog and a defunct newsletter to a single WordPress-powered instance on reyhan.org.

Sharing content on social media platforms is straightforward. I recognised for this initiative to succeed I had to ensure that posting on reyhan.org was just as easy.

To this end, I tailored WordPress to my needs:

  • Removed functionality that was superfluous, a distraction or maintenance burden.
  • Wrote a build script to tear down and rebuild the WordPress instance on Production.
  • Wrote a backup script to create backups of posts and the database.
  • Created a separate repository for the reyhan.org theme, using Vagrant to run the WordPress instance locally. GitLab’s Continuous Integration allows the theme to be updated and deployed to Production automagically.

I’ve been very happy with the results so far.

Separating concerns into three areas: build, backup and theme has worked remarkably well, and though upgrading WordPress and creating backups are currently manual processes, there’s no reason why these tasks couldn’t be automated in the future.

Moving WordPress to a different domain

Your mileage may vary! Please create the necessary backups and test locally before doing anything on Production.

When researching how to migrate WordPress content to reyhan.org, I read the Changing Your Domain_Name and URLs section on the Moving WordPress Codex article but it wasn’t very clear.

Having mentioned this to John, he kindly pointed me in the right direction — here’s what I did:

  1. Install wp-cli on both the old and new WordPress instances (if you haven’t already1).
  2. On the old WordPress instance run wp db export (docs) to export the database as a .sql file (it’ll look something like old_site_wp_database-2018-04-09-bun3e8h.sql).
  3. Transfer aforementioned .sql file to a location on the server running the new WordPress instance.
  4. On the new WordPress instance run wp site empty (docs).
  5. On the new WordPress instance run wp db import /path/to/*.sql (docs).
  6. On the new WordPress instance run wp search-replace old.com new.com (docs).

  1. wp-cli is a really well-designed command-line tool, it made my return to WordPress a great experience. 

App password gotcha with Google Authenticator plugin

When creating a new app password using the Google Authenticator plugin for WordPress don’t forget to click “Update Profile” after clicking “Create new password” or it won’t work.

EDIT: I’ve switched to Two-Factor. It has a better user experience and support for multiple methods of authentication.

Having tested using a stripped down WordPress instance for the past few months, I’ve successfully ported everything over to reyhan.org — though the changes are still propagating across the internet.

How to migrate from Jekyll to WordPress

Last month the decision was made to consolidate years of newsletters, weblog posts and other minutiae from various Jekyll instances to one WordPress-powered deal.

A fair amount of time was spent researching the best, quickest (and easiest!) way to do this but, unsurprisingly, most searches turned up the opposite: migrating from WordPress to Jekyll — anyway — here’s now it’s done:

Jekyll instance

  1. Install the Jekyll Feed plugin.
  2. Do a jekyll build and ensure the generated feed.xml has all the posts that are intended to be migrated.

WordPress instance

  1. Download and install the WP All Import plugin: wp plugin install wp-all-import --activate.
  2. In WordPress Admin, click on the All Import link and upload the feed.xml file generated earlier.
  3. Follow the four-step process to map and import the feed.xml data file into the WordPress instance.

I’d have saved a bunch of time had I been pointed at the WP All Import plugin from the beginning, so hopefully this will help somebody in the future.

Tag: wordpress