humanmade / hm-juicer
Integrates with Juicer API for social feeds and allows accessible display of social media content.
Installs: 44
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 21
Forks: 3
Open Issues: 34
Type:wordpress-plugin
Requires
- php: >=7.0
- cmb2/cmb2: ^2.6
- composer/installers: ^1.7
Requires (Dev)
- humanmade/asset-loader: ^0.3
- humanmade/coding-standards: ^0.7
- phpunit/phpunit: 5.7.*
- dev-develop
- 1.0.0
- dev-dependabot/npm_and_yarn/json5-1.0.2
- dev-dependabot/npm_and_yarn/express-4.18.2
- dev-dependabot/npm_and_yarn/qs-6.5.3
- dev-dependabot/npm_and_yarn/decode-uri-component-0.2.2
- dev-dependabot/npm_and_yarn/terser-4.8.1
- dev-dependabot/npm_and_yarn/eventsource-1.1.1
- dev-dependabot/npm_and_yarn/async-2.6.4
- dev-dependabot/npm_and_yarn/url-parse-1.5.10
- dev-dependabot/npm_and_yarn/follow-redirects-1.14.8
- dev-dependabot/npm_and_yarn/ajv-6.12.6
- dev-dependabot/npm_and_yarn/node-sass-7.0.0
- dev-dependabot/npm_and_yarn/path-parse-1.0.7
- dev-dependabot/npm_and_yarn/postcss-7.0.36
- dev-dependabot/npm_and_yarn/ws-6.2.2
- dev-dependabot/npm_and_yarn/dns-packet-1.3.4
- dev-dependabot/npm_and_yarn/hosted-git-info-2.8.9
- dev-dependabot/npm_and_yarn/lodash-4.17.21
- dev-dependabot/npm_and_yarn/y18n-3.2.2
- dev-dependabot/npm_and_yarn/elliptic-6.5.4
- dev-dependabot/npm_and_yarn/ini-1.3.8
- dev-dependabot/npm_and_yarn/http-proxy-1.18.1
- dev-master
- dev-move-composer-dependencies
- dev-bundle-built-assets
- dev-17-add-instagram-support
- dev-12-hm-asset-loader
- dev-add-webpack-config
- dev-gitignore-updates
- dev-update-readme
This package is auto-updated.
Last update: 2024-11-05 03:35:35 UTC
README
HM Juicer
Integrates with Juicer API for social feeds and allows accessible display of social media content.
Installation
With Git
Step 1
cd
into your desired directory (either wp-content/plugins
or wp-content/mu-plugins
) and clone the repository locally.
git clone git@github.com:humanmade/hm-juicer.git
With Composer
Install the plugin via composer
.
composer require humanmade/hm-juicer
Vendor packages are installed as WordPress plugins and will need to be activated manually from the Plugins page (or explicitly loaded if installing as a mu-plugin
).
For both: Configure environment
You may want to define environment variables that define your Juicer account and your site name and URLs. All of these are optional, but if any of them are not defined, a Settings page will appear in your admin to define these settings.
Step 1
Add the Juicer feed name to the wp-config.php
file via the JUICER_ID
constant.
define( 'JUICER_ID', 'myaccountname' );
This is the ID that is used in your Juicer feed URL, e.g. https://www.juicer.io/feeds/myaccountname
.
Step 2
Define your site name. This will affect how links appear in the Juicer feed.
define( 'JUICER_SITE_NAME', 'My Cool Site' );
Step 3
Add the Juicer long and short URLs. This is used to determine links that are coming from your site.
Note: While the short URL is intended for URL shorteners like a custom URL or a service like bit.ly, this can be any URL that links back to your site.
define( 'JUICER_SHORT_URL', 'short.url' ); define( 'JUICER_LONG_URL', 'mydomain.com' );
For both: Install dependencies
There are a number of dependencies that need to be installed if you are going to be using the Juicer plugin for development. At this time, this also needs to be done if you are not defining the constants above. To do this, cd
into the directory and run the setup command.
npm run setup
Usage
To add the Juicer feed to a page, simply use the function juicer_feed
in your template with the correct number of posts to display (and optionally, the page to display from). Documentation on the juicer_feed
function is available in the inc/README.md
file.
Credits
Created by Human Made to render and display accessible social media feeds via the Juicer API.
Maintained by Chris Reynolds.
Contributors:
This plugin depends on these libraries/technologies by some awesome developers:
Contributing
If you want to contribute, you'll need to get your local environment setup. We've provided an easy setup script to get all the NPM dependencies and any required Composer dependencies installed. Simply run the following command after checking out the repository and cd
ing into it:
npm run setup
In order to run unit tests locally, you'll need to make sure that you have a local version of PHP and MySQL/MariaDB installed (or run inside a virtual machine/Docker container). If your machine meets the requirements, you can run this command to get unit tests set up in your environment:
npm run setup:tests
(This is not run as part of the normal setup script because not every environment will support it.)
The development process follows the standard Human Made development process.
Here's a quick summary:
- Assign issues you're working on to yourself.
- Work on a branch per issue, something like
name-of-feature
. One branch per feature/bug, please. - File a PR early so it can be used for tracking progress.
- When you're finished, mark the PR for review by labelling with "Reviewer Needed".
- Get someone to review your code, and assign to them; if no one is around, the project lead can review.
Made with ❤️ by Human Made