itinerisltd/wp-hubspot-importer

Import HubSpot blog posts into WordPress.

0.4.1 2019-07-15 10:19 UTC

Requires

• php: ^7.2
• ryanwinchester/hubspot-php: ^1.1
• typisttech/wp-kses-view: ^0.5.0
• typisttech/wp-option-store: ^0.2.0

Requires (Dev)

• itinerisltd/itineris-wp-coding-standards: ^0.2.3
• phpstan/phpstan: ^0.11.4
• phpstan/phpstan-strict-rules: ^0.11.0
• roave/security-advisories: dev-master
• roots/wordpress: ^5.1
• wp-cli/wp-cli: ^2.1

MIT

• Tang Rufus
• Itineris Limited

• import
• wordpress
• wp
• hubspot

README

• Goal
• Minimum Requirements
• Installation
  • Composer (Recommended)
  • Classic
• Usage
  • OAuth2 Authorization
  • Importing from HubSpot to WordPress
• Data Structure
  • HubSpot Blog Post ID
  • Featured Image URL
• FAQ
  • Will you add support for older PHP versions?
  • It looks awesome. Where can I find some more goodies like this?
  • Besides wp.org, where can I give a ⭐⭐⭐⭐⭐ review?
• Testing
• Feedback
• Change Log
• Security
• Credits
• License

Goal

Import HubSpot blog posts into WordPress.

Minimum Requirements

• PHP v7.3
• WordPress v5.1

Installation

Composer (Recommended)

$ composer require itinerisltd/wp-hubspot-importer

Classic

Download wp-hubspot-importer.zip from GitHub releases Then, install as usual

Usage

OAuth2 Authorization

1. Head to WP Dashboard > Tools > WP HubSpot Importer
2. Authenticate WP HubSpot Importer to use HubSpot API on your behalf

Importing from HubSpot to WordPress

$ wp hubspot import
Importing from HubSpot...
Fetching HubSpot blog topics...
Success: Fetched Blog Topic: Blog (1111111111)
Success: Fetched Blog Topic: News (2222222222)
Fetching HubSpot blog posts updated since Tue, 23 Apr 2019 12:19:15 +0000...
Success: Imported Blog Post: I am the blog post title (3333333333)
Success: Imported Blog Post: Hello World (4444444444)
Success: Finished at Tue, 23 Apr 2019 12:20:38 +0000

Data Structure

By default, WP HubSpot Importer imports:

• HubSpot blog posts as post
• HubSpot blog topics as post_tag

See: BlogPostRepo::upsert

These can be customized by defining your own container via the wp_hubspot_importer_container_init filter.

HubSpot Blog Post ID

$wpPostId = 999;

// Returns '1234567890'
get_post_meta($wpPostId, Container::HUBSPOT_BLOG_POST_ID_META_KEY, true);

Featured Image URL

Featured images are not imported to WordPress media library, but the URLs are stored as custom post meta.

$wpPostId = 999;

// Returns 'https://cdn2.hubspot.net/hubfs/1234566/xxx.jpeg'
get_post_meta($wpPostId, Container::HUBSPOT_FEATURED_IMAGE_URL_META_KEY, true);

FAQ

Will you add support for older PHP versions?

Never! This plugin will only works on actively supported PHP versions.

Don't use it on end of life or security fixes only PHP versions.

It looks awesome. Where can I find some more goodies like this?

• Articles on Itineris' blog
• More projects on Itineris' GitHub profile
• More plugins on Itineris and TangRufus wp.org profiles
• Follow @itineris_ltd and @TangRufus on Twitter
• Hire Itineris to build your next awesome site

Besides wp.org, where can I give a ⭐⭐⭐⭐⭐ review?

Thanks! Glad you like it. It's important to let my boss knows somebody is using this project. Please consider:

• give ⭐⭐⭐⭐⭐ reviews on wp.org
• tweet something good with mentioning @itineris_ltd and @TangRufus
• ️️:star: star this Github repo
• watch this Github repo
• write blog posts
• submit pull requests
• hire Itineris

Testing

$ composer phpstan:analyse
$ composer style:check

Pull requests without tests will not be accepted!

Feedback

Please provide feedback! We want to make this library useful in as many projects as possible. Please submit an issue and point out what you do and don't like, or fork the project and make suggestions. No issue is too small.

Change Log

Please see CHANGELOG for more information on what has changed recently.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

WP HubSpot Importer is a Itineris Limited project created by Tang Rufus.

Full list of contributors can be found here.

License

WP HubSpot Importer is released under the MIT License.