# Connecting with Wordpress+

> The philosophy for authoring in Hail is still the same, however with Wordpress+ all Hail authors can push their content to certain parts of their Wordpress website, allowing you to create multiple connections for different types of Hail content. Because Wordpress is so modular, each instance of Wordpress is going to be unique, but here are the general customisations needed to make it hum with Hail.

## Overview
As a simple overview you are able to push articles and publications to Wordpress as post objects.

The title, Featured Image, Hail tags (to Wordpress tags), author, date and the body content are all pushed. Then from there you can show the Hail content as you would with any content authored in Wordpress.

The setup allows you to create connections with a single post category, so by default it is uncategorised but if you create categories in Wordpress and create a connection for each category as required. For filtering we suggest tags in Hail as they are pushed to Wordpress and easy for Hail admin team to managed rather than lots of connections for each category in Wordpress. However there are lots of options and flexibility depending on your needs.

## Setup Guide
1. In Wordpress go to `Posts` and create your categories for each connection (like `Article` and `Newsletter`) Hail will automatically push all public tags to Wordpress and further filtering can happen in Wordpress so these connection types should be only - `Articles`, `Publications`, `Notices`, `Alerts`.

Note: Tags for `sport`, `arts` etc should be created in Hail

2. Go to `Users` on Wordpress and choose an admin user
3. Scroll down and create an `Application Password`

## If you are using Wordfence (optional)
- Disable “Prevent discovery of usernames through ‘/?author=N’ scans, the oEmbed API, the WordPress REST API, and WordPress XML Sitemaps”
- Disable “Disable WordPress application passwords”
- Whitelist IPs with the following Hail IP addresses:
- `13.213.13.58`
- `54.187.252.11`
- `18.143.159.98`

## If you are using HTTP (and not HTTPS) (optional)
- add the following to functions.php

add_filter( 'wp_is_application_passwords_available', '__return_true' );

## If you are using Really Simple SSL (optional)

- Check that the setting `Disable user enumeration` is unticked

## If you are using Yoast SEO (optional)
- add the following to functions.php

remove_action('request', 'wordfence::preventAuthorNScans'); 

4. Go to Hail and select the Connections tab from the side bar
5. Scroll down to the `Blogging` section and select a new Wordpess Plus 6onnection
7. Enter your Wordpress site URL (e.g. `https://wordpress-site.co.nz`)
8. Enter your `username`

Note: (not the application password name, the actual users username)

9. Enter your `Application Password` that was generated in step 3
10. Click `Authorise`

At this point Hail will make the necessary calls to your Wordpress site, and the next steps allow you to customise your new Wordpress+ connection within Hail.

After customising you will be able to push your Hail content into Wordpress from the standard connections panel inside Hail’s Article & Publication edit screens

## Gotchas
#### If failing to push
- Check Upload Limit, possibly images might be too big, fix:
- ssh into the server (ssh root@ip)
- head to the file root (most commonly cd /var/www/html on our WP droplets)
- open the htaccess (sudo nano .htaccess)
- and insert after the wordpress section
- php_value upload_max_filesize 5M
- php_value post_max_size 7M