PHPackages humanmade/hm-juicer - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. humanmade/hm-juicer ActiveWordpress-plugin[API Development](/categories/api) humanmade/hm-juicer =================== Integrates with Juicer API for social feeds and allows accessible display of social media content. 1.0.0(6y ago)4472[13 issues](https://github.com/humanmade/hm-juicer/issues)[21 PRs](https://github.com/humanmade/hm-juicer/pulls)GPL-3.0-or-laterPHPPHP >=7.0 Since Oct 24Pushed 3y ago18 watchersCompare [ Source](https://github.com/humanmade/hm-juicer)[ Packagist](https://packagist.org/packages/humanmade/hm-juicer)[ RSS](/packages/humanmade-hm-juicer/feed)WikiDiscussions develop Synced 5d ago READMEChangelogDependencies (5)Versions (31)Used By (0) [![Human Made Logo](https://camo.githubusercontent.com/0563c4ffdc2d461425e0fa167430e989bdbe0b4ab14e87f1e001628d668ba68c/68747470733a2f2f68756d616e6d6164652e636f6d2f636f6e74656e742f7468656d65732f68756d616e6d6164652f6c69622f686d2d7061747465726e2d6c6962726172792f6173736574732f696d616765732f6c6f676f732f6c6f676f2d7265642e737667)](https://camo.githubusercontent.com/0563c4ffdc2d461425e0fa167430e989bdbe0b4ab14e87f1e001628d668ba68c/68747470733a2f2f68756d616e6d6164652e636f6d2f636f6e74656e742f7468656d65732f68756d616e6d6164652f6c69622f686d2d7061747465726e2d6c6962726172792f6173736574732f696d616765732f6c6f676f732f6c6f676f2d7265642e737667) [![Juicer.io logo](https://avatars3.githubusercontent.com/u/4896003?s=20)](https://avatars3.githubusercontent.com/u/4896003?s=20) HM Juicer =========================================================================================================================================== [](#-hm-juicer) Integrates with Juicer API for social feeds and allows accessible display of social media content. Installation ------------ [](#installation) ### With Git [](#with-git) #### Step 1 [](#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 [](#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 [](#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 [](#step-1-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 [](#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 [](#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 [](#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 ----- [](#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`](inc/README.md) file. Credits ------- [](#credits) Created by Human Made to render and display accessible social media feeds via the Juicer API. Maintained by [Chris Reynolds](https://github.com/jazzsequence). Contributors: - [Joeleen Kennedy](https://github.com/joeleenk) - [Rian Rietveld](https://github.com/rianrietveld) This plugin depends on these libraries/technologies by some awesome developers: - [CMB2/CMB2](https://github.com/CMB2/CMB2) - [humanmade/webpack-helpers](https://github.com/humanmade/webpack-helpers) - [humanmade/asset-loader](https://github.com/humanmade/asset-loader) - [Babel](https://babeljs.io/) - [ESLint](https://eslint.org/) - [Webpack](https://webpack.js.org/) - [Sass](https://sass-lang.com/) Contributing ------------ [](#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](http://engineering.hmn.md/how-we-work/process/development/). 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](https://humanmade.com) ### Health Score 25 — LowBetter than 37% of packages Maintenance0 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community16 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 61.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 2349d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/af6c0ce1d250a8a8edc57b4759dabc3d5f7956fc105450bba7fc5d2eb5b74362?d=identicon)[jazzsequence](/maintainers/jazzsequence) --- Top Contributors [![sambulance](https://avatars.githubusercontent.com/u/5014023?v=4)](https://github.com/sambulance "sambulance (30 commits)")[![jazzsequence](https://avatars.githubusercontent.com/u/991511?v=4)](https://github.com/jazzsequence "jazzsequence (13 commits)")[![johnbillion](https://avatars.githubusercontent.com/u/208434?v=4)](https://github.com/johnbillion "johnbillion (6 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/humanmade-hm-juicer/health.svg) ``` [![Health](https://phpackages.com/badges/humanmade-hm-juicer/health.svg)](https://phpackages.com/packages/humanmade-hm-juicer) ``` ### Alternatives [sybrew/the-seo-framework An automated, advanced, accessible, unbranded and extremely fast SEO solution for any WordPress website. 47078.8k](/packages/sybrew-the-seo-framework)[a2design-company/mandrill-cakephp-plugin Mandrill CakePHP plugin 193.2k](/packages/a2design-company-mandrill-cakephp-plugin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)