WordPress Plugin – Json Articles

Wordpress Plugin - Json Articles

Posted:  October 14, 2021

Wordpress Plugin - Json Articles

Back when I was attempting to be a small hosting business in Western Mass, I ran a side site for supporting my clients where I wrote most of the articles you now see here. In addition to displaying them on my support site, I also wanted to be able to display them on the companies main site.

Rather than rewriting, or exporting/importing the articles, I decided to leverage the built-in WordPress Rest API and wrote this plugin to do it all for me.


What this plugin does is pulls in articles from another WordPress site through the normal json endpoints, it then parses the categories, tags, and attempts to pull the media. You can change the permalinks for each, create a sidebar and add widgets to existing sidebars.

We do inject an “Original Article” with the link back to the original page. You cannot remove this link through the plugin, please do not hack it to remove and give credit where credit is due!


  • Ability to pull blog articles from another WordPress website
    • Configured site must have the JSON API enabled.
  • Creates or Updates posts, categories, tags, and tries to create the media for the posts
  • Configurable and filterable by category, tag, or date range of articles to pull.
  • Configurable permalinks
  • Number of articles to pull (max 100, this is a WordPress JSON API limit)
  • Manual, cron, and cli based syncing.
    • I would not recommend manual syncing for anything over 20 articles
  • Includes basic templates
    • To use them, simply copy the files in this plugins templates/ directory to your theme’s root directory and make your modifications.

Directions & Settings


  • Download the plugin, unzip it, and upload to your sites /wp-content/plugins/ directory
    • You can also upload it directly to your Plugins admin
  • Activate the plugin through the ‘Plugins’ menu in WordPress

Settings & Sync

Main Settingsmain settings

  • Site URLThe full URL to the site you wish to attempt to pull articles from, ex… http(s)://yoursite.comNOTES: The site you are pulling from must allow the JSON API, and you do not need to know the endpoints for the posts, the plugin takes care of that for you.
  • Article PermalinkThe base permalink for displaying the articles.
  • Category PermalinkThe base permalink for displaying the article categories.
  • Tag PermalinkThe base permalink for displaying the article tags.
  • Article Display CountHow many articles should be displayed per page?
  • Article Pull CountHow many articles should the sync pull?NOTE: WordPress JSON only allows a maximum of 100 articles.
  • Category Filter Comma-delimited list of categories from the originating site to pull the articles from.NOTE: Defaults to all Categories
  • Tag Filter Comma-delimited list of tags from the originating site to pull the articles from.NOTE: Defaults to all Tags
  • Date Filter – Start “Published On” start date pull the articles from the originating site.NOTE: Defaults to all
  • Date Filter – End “Published On” end date pull the articles from the originating site.NOTE: Defaults to all

Sync Settingssync settings

  • Sync Span Select the span of time that you would like to sync the articles. Pulls the pre-exising WordPress scheduling.
  • Manual Sync Click to manually sync the articles, please stay on the page while it is running to prevent any interuptions.NOTE: I do not recommend doing this for any pull over 10 or so articles. It could timeout.
  • CLI Sync Log into your webservers shell, and run the following command in your sites root: wp kp_ja sync.NOTE: If your site is a multisite install, specifically a subdomain type, please add this flag to your command: --url=http(s)://THEURLTOYOURSITE.ext

Sidebar & Widgets

  • Sidebar – JSON Articles We added a sidebar for use in the article templates if you need to.
  • Widgets
    • JSON Article Categories Works exactly like the built-in “Categories” widget, except pulls from these JSON Articles.
    • JSON Article Tags Displays a tag cloud of the JSON Articles Tags.
    • JSON Recent Articles Displays a menu of the most recent JSON Articles.

Articles and Templates

  • Files – main location: wp-content/THISPLUGIN/templates/*To override our template simply copy them to your themes root directory, and make your modifications.
    • kpja-archives.php This is the main article listing page, just like your archive.php or index.php template files.
    • kpja-category.php This is the article category listing page, just like your category.php template file.
    • kpja-single.php This is the single article page, just like your single.php template file.
    • kpja-tag.php This is the article tag listing page, just like your tag.php template file.


= 0.8.77 =
* VERIFY: Core 5.9 Compliant
* FEATURE: create some action hooks, listed below
    * `kpja_admin_permissions` - fires off after the admin pages permissions are squared away for the articles.
    done in case developers need more control over the permissions already set
    * `kpja_pre_cpt_create` - fires off before the custom post type is created
    * `kpja_post_cpt_create` - fires off after the custom post type is created
    * `kpja_pre_tax_create` - fires off before the taxonomies are created
    * `kpja_post_tax_create` - fires off after the taxonomies are created
* FIX: Revamped the article image pulling.  Should get all post thumbnails attached to a remote post now.
    - implemented a sample in the template kpja-single.php to show it working.

= 0.7.14 =
* VERIFY: Core 5.8.1 Compliant

= 0.7.13 =
* FIX: remote pull issue on non-https
* FIX: throw proper error messages on issue
* FIX: proper OR for file DIE on direct access
* FIX: properly pull the documentation and sync info pages
* FIX/FEATURE: replace get with safe get
* FEATURE: strongly type methods
* FEATURE: updated comments to phpdoc format

= 0.6.97 =
* framework update
* 5.8 compatibility
* force php 7.3 minimum

= 0.3.13 =
* framework update
* WP Core Version update

= 0.2.07 =
* Check for existing classes
* Test for 5.7 compliance
* Remove un-necessary includes
* CLI sync performance
* Update field framework

= 0.1.91 =
* First public release



Kevin Pirnie

Kevin Pirnie

20+ Years of PC and server maintenance & over 15+ years of web development/design experience; you can rest assured that I take every measure possible to ensure your computers are running to their peak potentials. I treat them as if they were mine, and I am quite a stickler about keeping my machines up to date and optimized to run as well as they can.

Our Privacy Policy

Revised: June 8, 2021

Thank you for choosing to be part of my website at https://kevinpirnie.com (“Company”, “I”, “me”, “mine”). I am committed to protecting your personal information and your right to privacy. If you have any questions or concerns about this privacy notice, or my practices with regards to your personal information, please contact me at .

When you visit my website https://kevinpirnie.com (the “Website”), and more generally, use any of my services (the “Services”, which include the Website), I appreciate that you are trusting me with your personal information. I take your privacy very seriously. In this privacy notice, I seek to explain to you in the clearest way possible what information we collect, how I use it and what rights you have in relation to it. I hope you take some time to read through it carefully, as it is important. If there are any terms in this privacy notice that you do not agree with, please discontinue use of my Services immediately.

This privacy notice applies to all information collected through my Services (which, as described above, includes our Website), as well as, any related services, sales, marketing or events.

Please read this privacy notice carefully as it will help you understand what I do with the information that I collect.


Information automatically collected

In Short: Some information – such as your Internet Protocol (IP) address and/or browser and device characteristics – is collected automatically when you visit my Website.

I automatically collect certain information when you visit, use or navigate the Website. This information does not reveal your specific identity (like your name or contact information) but may include device and usage information, such as your IP address, browser and device characteristics, operating system, language preferences, referring URLs, device name, country, location, information about how and when you use our Website and other technical information. This information is primarily needed to maintain the security and operation of our Website, and for our internal analytics and reporting purposes.

Like many businesses, I also collect information through cookies and similar technologies.

The information I collect includes:
Log and Usage Data. Log and usage data is service-related, diagnostic, usage and performance information our servers automatically collect when you access or use our Website and which we record in log files. Depending on how you interact with us, this log data may include your IP address, device information, browser type and settings and information about your activity in the Website (such as the date/time stamps associated with your usage, pages and files viewed, searches and other actions you take such as which features you use), device event information (such as system activity, error reports (sometimes called ‘crash dumps’) and hardware settings).

Device Data. I collect device data such as information about your computer, phone, tablet or other device you use to access the Website. Depending on the device used, this device data may include information such as your IP address (or proxy server), device and application identification numbers, location, browser type, hardware model Internet service provider and/or mobile carrier, operating system and system configuration information.

Location Data. I collect location data such as information about your device’s location, which can be either precise or imprecise. How much information I collect depends on the type and settings of the device you use to access the Website. For example, I may use GPS and other technologies to collect geolocation data that tells me your current location (based on your IP address). You can opt out of allowing me to collect this information either by refusing access to the information or by disabling your Location setting on your device. Note however, if you choose to opt out, you may not be able to use certain aspects of the Services.


In Short: I process your information for purposes based on legitimate business interests, the fulfillment of my contract with you, compliance with my legal obligations, and/or your consent.

I use personal information collected via my Website for a variety of business purposes described below. I process your personal information for these purposes in reliance on my legitimate business interests, in order to enter into or perform a contract with you, with your consent, and/or for compliance with my legal obligations. I indicate the specific processing grounds I rely on next to each purpose listed below.

For other business purposes. I may use your information for other business purposes, such as data analysis, identifying usage trends, determining the effectiveness of our promotional campaigns and to evaluate and improve my Website, products, marketing and your experience. I may use and store this information in aggregated and anonymized form so that it is not associated with individual end users and does not include personal information. I will not use identifiable personal information without your consent.


In Short: I only share information with your consent, to comply with laws, to provide you with services, to protect your rights, or to fulfill business obligations.


In Short: I may use cookies and other tracking technologies to collect and store your information.

I may use cookies and similar tracking technologies (like web beacons and pixels) to access or store information. Specific information about how I use such technologies and how you can refuse certain cookies is set out in our Cookie Notice.


In Short: We may transfer, store, and process your information in countries other than your own.

My servers are located in the United States of America, unless otherwise requested by my clients. If you are accessing my Website from outside, please be aware that your information may be transferred to, stored, and processed by me in my facilities and by those third parties with whom I may share your personal information (see “WILL YOUR INFORMATION BE SHARED WITH ANYONE?” above), in and other countries.

If you are a resident in the European Economic Area, then these countries may not necessarily have data protection laws or other similar laws as comprehensive as those in your country. I will however take all necessary measures to protect your personal information in accordance with this privacy notice and applicable law.


In Short: I keep your information for as long as necessary to fulfill the purposes outlined in this privacy notice unless otherwise required by law.

I will only keep your personal information for as long as it is necessary for the purposes set out in this privacy notice, unless a longer retention period is required or permitted by law (such as tax, accounting or other legal requirements). No purpose in this notice will require me keeping your personal information for longer than 6 months.

When I have no ongoing legitimate business need to process your personal information, I will either delete or anonymize such information, or, if this is not possible (for example, because your personal information has been stored in backup archives), then I will securely store your personal information and isolate it from any further processing until deletion is possible.


In Short: I aim to protect your personal information through a system of organizational and technical security measures.

I have implemented appropriate technical and organizational security measures designed to protect the security of any personal information I process. However, despite our safeguards and efforts to secure your information, no electronic transmission over the Internet or information storage technology can be guaranteed to be 100% secure, so I cannot promise or guarantee that hackers, cybercriminals, or other unauthorized third parties will not be able to defeat my security, and improperly collect, access, steal, or modify your information. Although I will do my best to protect your personal information, transmission of personal information to and from my Website is at your own risk. You should only access the Website within a secure environment.


In Short: I do not knowingly collect data from or market to children under 18 years of age.

I do not knowingly solicit data from or market to children under 18 years of age. By using the Website, you represent that you are at least 18 or that you are the parent or guardian of such a minor and consent to such minor dependent’s use of the Website. If I learn that personal information from users less than 18 years of age has been collected, I will deactivate the account and take reasonable measures to promptly delete such data from my records. If you become aware of any data I may have collected from children under age 18, please contact me at .


In Short: You may review, change, or terminate your account at any time.

If you are a resident in the European Economic Area and you believe I am unlawfully processing your personal information, you also have the right to complain to your local data protection supervisory authority. You can find their contact details here: http://ec.europa.eu/justice/data-protection/bodies/authorities/index_en.htm.

If you are a resident in Switzerland, the contact details for the data protection authorities are available here: http://ec.europa.eu/justice/data-protection/bodies/authorities/index_en.htm.

Cookies and similar technologies: Most Web browsers are set to accept cookies by default. If you prefer, you can usually choose to set your browser to remove cookies and to reject cookies. If you choose to remove cookies or reject cookies, this could affect certain features or services of my Website.


Most web browsers and some mobile operating systems and mobile applications include a Do-Not-Track (“DNT”) feature or setting you can activate to signal your privacy preference not to have data about your online browsing activities monitored and collected. At this stage no uniform technology standard for recognizing and implementing DNT signals has been finalized. As such, I do not currently respond to DNT browser signals or any other mechanism that automatically communicates your choice not to be tracked online. If a standard for online tracking is adopted that I must follow in the future, I will inform you about that practice in a revised version of this privacy notice.


In Short: Yes, if you are a resident of California, you are granted specific rights regarding access to your personal information.

California Civil Code Section 1798.83, also known as the “Shine The Light” law, permits my users who are California residents to request and obtain from me, once a year and free of charge, information about categories of personal information (if any) I disclosed to third parties for direct marketing purposes and the names and addresses of all third parties with which I shared personal information in the immediately preceding calendar year. If you are a California resident and would like to make such a request, please submit your request in writing to me using the contact information provided below.

If you are under 18 years of age, reside in California, and have a registered account with the Website, you have the right to request removal of unwanted data that you publicly post on the Website. To request removal of such data, please contact us using the contact information provided below, and include the email address associated with your account and a statement that you reside in California. I will make sure the data is not publicly displayed on the Website, but please be aware that the data may not be completely or comprehensively removed from all my systems (e.g. backups, etc.).


In Short: Yes, I will update this notice as necessary to stay compliant with relevant laws.

I may update this privacy notice from time to time. The updated version will be indicated by an updated “Revised” date and the updated version will be effective as soon as it is accessible. If I make material changes to this privacy notice, I may notify you either by prominently posting a notice of such changes or by directly sending you a notification. We encourage you to review this privacy notice frequently to be informed of how I am protecting your information.


If you have questions or comments about this notice, you may email me at or by post to:

Kevin C. Pirnie

22 Orlando St.
Feeding Hills, MA 01030
United States of America


Based on the applicable laws of your country, you may have the right to request access to the personal information I collect from you, change that information, or delete it in some circumstances. To request to review, update, or delete your personal information, you may email me at or by post to:

Kevin C. Pirnie

22 Orlando St.
Feeding Hills, MA 01030
United States of America