Using the XML Export File to Replicate This Site

Although there are simpler, better ways to replicate the Communicating with Prisoners ortext, you can get the job done using the XML export file and other content files from the site source archive.

Here are steps to create a working replica of this site using the XML file:

  1. Download the Communicating with Prisoners ortext source archive. This will be called the source. See the download page for details on where to find specific items within the source.
  2. Install WordPress on your web server.
  3. Set up the correct permalinks. Within the WordPress admin Settings -> Permalinks, change the permalink form by setting the Post name button. Set the Category Base to section and the Tag base to topic
  4. Set up the media. Within the WordPress admin Settings -> Media, change the medium size to 550×550 and uncheck Organize my uploads into month- and year-based folders
  5. Replace the uploads folder. Use standard tools to replace your WordPress installations uploads folder with the source uploads folder. For an online server, you upload a folder to WordPress installation independently of WordPress using a ftp or sftp (better) program. If you don’t do that, you won’t see the faces of the prisoners and you won’t see any graphs or images within the content.
  6. Add the Ortext theme to your installation. If you zip the relevant source ortext theme folder, you can upload it within WordPress admin via Appearance -> Themes, click on Add New button, and then click on Upload button. Alternatively, you need to transfer the folder to your wp-content/themes directory using standard tools. Once you have moved the Ortext theme (ortext theme folder) into your WordPress installation, activate the Ortext theme.
  7. Add two Ortext plugins and TablePress to your installation. The two ortext plugins are Ortext Formating and Ortext Datalinks. If you zip the relevant source plugin folders otx-format and otx-datalinks, you can upload them within WordPress admin via Plugins -> Add New, and click on the Upload Plugin button. Alternatively, you need to move those plugin folders to your wp-content/plugins directory using standard tools. TablePress can be installed similarly, or from the WordPress plugin directory. Once you have installed the three plugins Ortext Formating, Ortext Datalinks, and TablePress, activate them.
  8. Rebase the hyperlinks if necessary. The Communicating with Prisoners XML content file communicatingwithprisoners.wordpress.{date}.xml has internal links with the base localhost/wordpress.  If that’s not your host URL, you need to re-based the internal links. That means changing all instances of localhost/wordpress (search) to example.com (replace), where you substitute your base URL for example.com. You can do this with a search-and-replace on the xml content using a simple code editor such as Notepad++.  Don’t use a word processor such as Microsoft Word. If you have installed your server locally at localhost/wordpress, you don’t have to do these search-and-replaces because the search and replace strings are identical.
  9. Import ortext XML content. Make sure first that you have the Ortext plugins activated so that you see Notes, Statistics, Datasets, etc. in the left menu. Within WordPress admin Tools -> Import, click on WordPress. You will be prompted to install the WordPress Importer plugin. Alternatively, you may have to install it from the WordPress directory at Plugins -> Add New. Activate it and go back to Tools -> Import as above. When you get to the WordPress Importer import screen, browse for the site archive file communicatingwithprisoners.wordpress.{date}.xml That’s the one to import. Click Upload File and Import. On the subsequent screen, assign all post to the user name you created at installation (do that through the drop-down box). DO NOT check the Importer’s checkbox for Download and import file attachments.  Perform the content import. It could take 5 minutes or more to complete. You will see a completion note appear on the screen. The media imports will fail. Don’t worry about that.
  10. Customize the Ortext theme. Make sure it’s active. Go to WordPress admin Appearance -> Customize.
    • Expand the Navigation customization. Set the Primary Menu as left nav and the Secondary Menu as right nav.
    • Expand Widgets -> Footer Widget. Open each of the footer widget items and remove them.
    • Expand the Static Front Page customization and set Static Page. Then choose for the front page Front Page: Communicating with Prisoners.
    • Click on Save & Publish at the top of the column. Exit via the top left X.
  11. Import the TablePress tables and css.  Go to TablePress -> Import a Table. Browse for the import file tablepress-export-{data and time}-json.zip Set the import format to JSON. Press the Import button to import the tables. Then at TablePress -> Plugin Options, copy and paste the css contents of the source file tablepress-custom-css.txt into the relevant box. Press the Save Changes button.

If you have successfully completed all these steps, you’re good. Even if you have messed up some step, you should still have some content for ortext experimentation.

Unfortunately, the hyperlinks in the TablePress files are probably wrong. They point to http://localhost/wordpress/…. A search-and-replace is burdensome because the TablePress tables are archived in JSON (which has a backslash before the forward slash) and each table is in a separate fie. So it’s easiest simply to edit manually the hyper links for each table (usually only one hyperlink per table) through the TablePress editor in the WordPress admin. Alternatively, just don’t worry about the problem of non-functioning source links in the TablePress tables.

Unless you’ve installed locally at localhost/wordpress, the source media won’t appear in the admin Media panel. That’s because the attachments aren’t set up correctly. Don’t worry about that for an experimental site. Even though it doesn’t appear in the media admin panel, all the media will appear correctly on the site’s front end. If you want to modify any of the media and use it elsewhere in the content, re-upload it within WordPress via the standard WordPress insert media process. You can also do that to recreate the media in the media folder if you are unable simply to move the media there.

Leave a comment (will be included in public domain license)

Your email address will not be published. Required fields are marked *