<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p data-pasted="true"><strong>In this guide we will cover:</strong></p><p><strong>- What is the Wordpress.com Integration?</strong></p><p><strong>- Connecting to a Wordpress.com Site</strong></p><p><strong>- Importing Posts</strong></p><p><strong>- Enabling the Halo Integrator</strong></p><p><br></p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;">What is the Wordpress.com Integration?</span></strong></p><p>The Wordpress.com integration can import posts from a hosted Wordpress site as Knowledge Base articles in Halo. </p><p><br></p><p><strong><em>Note: If the website is self-hosted, you must use the </em></strong><a href="https://usehalo.com/haloitsm/guides/2828/" target="_blank" rel="noopener noreferrer"><strong><em>Wordpress.org</em></strong></a><strong><em> integration instead.</em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to a Wordpress.com Site</span></strong></p><p>In Configuration > Integrations, you will find the Wordpress.com module in the Documentation section. Hover over the module, and click the plus icon to enable it.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFmMjQwMjdlLTdiZmMtNGE2Yi1hMGVkLTczY2JhMTU0OThiMSJ9.WuXRfWnJu4pUX8uIDQRffl8_uq2GveeP_SWvpyl49IM" class="fr-fic fr-fil fr-dib" width="96" height="126"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the Wordpress.com integration</span></strong></p><p><br></p><p>Clicking into the module, you will see an option to "Add/Edit Wordpress Connections".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjllY2NmMWI5LWEyYjAtNDZmOS1hODhkLTE3NGM1OTEwOTUwMSJ9.VzDT0KVkeWeZmKq22efonO5O0jDN1qYxCd2IsFCak_w" class="fr-fic fr-fil fr-dib" width="1344" height="672"></p><p><strong><span style="font-size: 10pt;">Fig 2. Navigating to connect to Wordpress.com </span></strong></p><p><br></p><p>Multiple Wordpress.com connections can be made; either choose an existing one to edit or click the "New" button.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRkZmU0M2U1LTMwODEtNGZlMC1iZGMyLTU1NTg4YWJlYzRmYyJ9.E1-j8nw634YAkJFKGbskuyjxnoykNDuYx4in6QHTKLQ" class="fr-fic fr-fil fr-dib" width="1699" style="width: 1701px; height: 105.44px;" height="105"></p><p><strong><span style="font-size: 10pt;">Fig 3. Wordpress.com connection list</span></strong></p><p><br></p><p>Give the connection a relevant name, and save.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ1YWI0ZWQ3LTQ1NzEtNDdjNC1iNDRmLWZmZGM2NTA2NjYwYyJ9.jfV4GnNE2EJWZCvnwMxtoCKGIbDvYjq46-6tNOaFoqw" class="fr-fic fr-fil fr-dib" width="1199" height="336"></p><p><strong><span style="font-size: 10pt;">Fig 4. Naming the connection</span></strong></p><p><br></p><p>Click the "Login with Wordpress.com" button to connect. Ensure an admin user is used, and that admin user has an associated site URL.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg3NTc2MmY4LTFkZGYtNGY2Zi05MmMwLWNhZDViOTI3MmI5ZSJ9.Ho1zUUwY81s7RiY0csSLvwu4RhnnszQNLuEd5kNRzJ8" class="fr-fic fr-fil fr-dib" width="295" height="436"></p><p><strong><span style="font-size: 10pt;">Fig 5. Login button</span></strong></p><p><br></p><p>After a successful login, the "Authorised" field will change to "Yes". The site URL will also show in the columns shown in Figure 3. If blank, the user used to log in is not associated as an admin user for that site.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI4NmQ2YzA1LWMxMGYtNGMyNC1hZTg0LTY4NWM5MWNjNzE0YyJ9.WMyiUFOiAyGdz1bahgHkWLx93M_7Elp9dfAtZwfzUac" class="fr-fic fr-fil fr-dib" width="349" height="381"></p><p><strong><span style="font-size: 10pt;">Fig 6. Authorised login field</span></strong></p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;">Importing Posts</span></strong></p><p>Within the main section of the Wordpress.com module, click the "Import Wordpress Posts" button. Anything within the "Posts" section of the Wordpress.com site, that has not been filtered out by tag, will show in this import screen.</p><p><br></p><ul data-pasted="true"><li><strong>Only import Posts with this Tag: </strong>If set, only posts that match this tag will be imported.</li><li><strong>Import categories of Posts as FAQ Lists: </strong>The category set against the post will be created as an FAQ list, and the<strong> </strong>article set against that list.<strong> </strong>"Owner" access control will be given to the agent who imports the post. Any other levels of access control must be manually given.</li><li><strong>Default FAQ List: </strong>This will import all posts against this FAQ list. This will only show if the above setting is disabled.</li></ul><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMzZTVjY2FiLTZhMjQtNDcwZS04ODIwLTZmMjFkMTI1ZmUzNCJ9.4vf_o_VvdmX8spJNS8SuPOiruxCSDdoP1iOxbdH2RwM" class="fr-fic fr-fil fr-dib" width="429" height="385"></p><p><strong><span style="font-size: 10pt;">Fig 6. Importing posts via API</span></strong></p><p><br></p><p>The posts will show in the corresponding FAQ list. The "Created by" field does not get set upon first import, but further updates to the same article/post will show the "Edited by" field. If article reviews are enabled, the "Next Review Date" will be set by the default number of days in Configuration > Knowledge Base > "Default Number Of Days Between Reviews".</p><p><br></p><p>If using categories as FAQ lists, the article will be added to multiple FAQ lists if added to multiple categories, and if these categories change, they will be removed from these FAQ lists upon the next import (either manually or via the Halo Integrator).</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImIwZWNmMzJmLTIyMTEtNDI4ZC1iY2FjLWNhZjJiMGI3MGEyNyJ9.UgBNcaaWACGfqi6IXPjJVwFjA0BNOUt8o0nAMce9I34" class="fr-fic fr-fil fr-dib" width="1694" style="width: 1696px; height: 856.819px;" height="857"></p><p><strong><span style="font-size: 10pt;">Fig 7. Imported article and FAQ list</span></strong></p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;">Enabling the Halo Integrator</span></strong></p><p>Posts can be imported once a day via the Halo integrator to create or update articles. In the main section of the module, select "Enable the Halo Integrator for the Wordpress.com integration".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQxMDRmZDI3LTU2ZDEtNDRlOC1hMTQzLWI4MTVmMGZkNjJiNyJ9.U2sYClkjA0k8f5K2VNvHq5eVdMQLW8rDgtdaAZoXy0c" class="fr-fic fr-fil fr-dib" width="1312" height="260"></p><p><strong><span style="font-size: 10pt;">Fig 8. Enabling the Halo integrator</span></strong></p>
