PHPackages                             webdevstudios/wds-shortcodes - 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. [Parsing &amp; Serialization](/categories/parsing)
4. /
5. webdevstudios/wds-shortcodes

ActiveWordpress-plugin[Parsing &amp; Serialization](/categories/parsing)

webdevstudios/wds-shortcodes
============================

Base plugin/classes/functionality for creating shortcodes.

v1.0.7(8y ago)2524913[3 issues](https://github.com/WebDevStudios/WDS-Shortcodes/issues)GPL-2.0+PHPPHP &gt;5.2

Since Mar 21Pushed 6y ago47 watchersCompare

[ Source](https://github.com/WebDevStudios/WDS-Shortcodes)[ Packagist](https://packagist.org/packages/webdevstudios/wds-shortcodes)[ Docs](https://github.com/WebDevStudios/WDS-Shortcodes)[ RSS](/packages/webdevstudios-wds-shortcodes/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (12)Used By (0)

WDS Shortcodes
==============

[](#wds-shortcodes)

**Contributors:** [WebDevStudios](https://github.com/WebDevStudios), [jtsternberg](https://github.com/jtsternberg), [JayWood](https://github.com/JayWood)
**Donate link:**
**Tags:** shortcode button, shortcodes, cmb2, utility
**Requires at least:** 4.3
**Tested up to:** 4.3
**Stable tag:** 1.0.7
**License:** GPLv2
**License URI:**

[![WebDevStudios. WordPress for big brands.](https://camo.githubusercontent.com/49083ad2ec31f613b1a1a1e5248ba5ee38d09cf189480d57be5b5683b0cca709/68747470733a2f2f77656264657673747564696f732e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031382f30342f7764732d6769746875622d62616e6e65722e706e67)](https://webdevstudios.com/contact/)

Description
-----------

[](#description)

WDS-Shortcodes gives developers the ability to easily register shortcodes with a corresponding button, so never again will your client ask, *What's that shortcode again?* Not only can you easily handle the button and shortcode registration, this also supports self-closing and wrapping shortcodes with a simple config flag.

**Please note:** you will need to run `composer install` in order to fetch the dependenceis for this plugin/library, **or** you can [download the zip here](https://github.com/WebDevStudios/WDS-Shortcodes/blob/master/wds-shortcodes.zip?raw=true).

Additionally, there is also built-in [CMB2](http://wordpress.org/plugins/cmb2/) support so you can use all your favorite fields.

For more info, [check out the wiki](https://github.com/WebDevStudios/WDS-Shortcodes/wiki).

To see a demo plugin, check out "[Cool Shortcode](https://github.com/jtsternberg/Cool-Shortcode)".

Installation
------------

[](#installation)

### Manual Installation

[](#manual-installation)

1. Upload the entire `/wds-shortcodes` directory to the `/wp-content/plugins/` directory.
2. Activate WDS Shortcodes through the 'Plugins' menu in WordPress.

Frequently Asked Questions
--------------------------

[](#frequently-asked-questions)

- None as of yet

Screenshots
-----------

[](#screenshots)

[![](https://raw.githubusercontent.com/WebDevStudios/WDS-Shortcodes/master/screenshot1.png)](https://raw.githubusercontent.com/WebDevStudios/WDS-Shortcodes/master/screenshot1.png)

Changelog
---------

[](#changelog)

### 1.0.7

[](#107)

- Update for new version of shortcode button, where `ajax_parse_shortcode` is now an object method (vs class method).

### 1.0.6

[](#106)

- Update shortcode-button dependency. [See changelog](https://github.com/jtsternberg/Shortcode_Button#changelog).

### 1.0.5

[](#105)

- Update shortcode-button dependency. [See changelog](https://github.com/jtsternberg/Shortcode_Button#changelog).

### 1.0.4

[](#104)

- Update shortcode-button dependency to fix modal displaying before CSS loads.

### 1.0.3

[](#103)

- `WDS_Shortcode_Instances::get()` now accepts a secondary argument, `$index`, for selecing the exact object instance under the shortcode namespace.

### 1.0.2

[](#102)

- Add new method, `WDS_Shortcode::json_decode_att()`, for getting decoded json attribute values. Handles converting the pseudo-json format used when storing array field datat.

### 1.0.1

[](#101)

- Add new method, `WDS_Shortcode::bool_att()`, for getting boolean attribute values. Handles converting "false" and "0" strings to false.
- Undefined notice fix: Check if attribute value is a string before checking if it is json.
- Fix issue where faux json\_encoded arrays were not being properly translated back to a php array.

### 1.0.0

[](#100)

- Update to be used as a library primarily (using [wp-lib-loader](https://github.com/jtsternberg/wp-lib-loader)). Will break back-compat for plugins extending the `WDS_Shortcode_Admin` class before the `'init'` hook.

### 0.1.3

[](#013)

- Update composer lock file and zip file after updating Shortcode\_Button dependency.

### 0.1.2

[](#012)

- New method, `WDS_Shortcode::maybe_json()` which automatically converts attributes from the modifed JSON string [created by Shortcode\_Button](https://github.com/jtsternberg/Shortcode_Button/commit/c186e98b2f94a1e565d85593033d9b2a499d9e8e#diff-6846d1b0c8144484af006af499cd053dR397) into a normal PHP array.

### 0.1.1

[](#011)

- Fix issues with ajax hooks not working (as they get hooked too late)

### 0.1.0

[](#010)

- First release

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 65.5% 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

Every ~44 days

Recently: every ~93 days

Total

11

Last Release

3257d ago

Major Versions

v0.1.3 → v1.0.02016-03-28

### Community

Maintainers

![](https://www.gravatar.com/avatar/204f41ec695703a1363f27b8e65667efbb491e78a15f5dba772bfce88a7a277b?d=identicon)[jtsternberg](/maintainers/jtsternberg)

---

Top Contributors

[![jtsternberg](https://avatars.githubusercontent.com/u/1098900?v=4)](https://github.com/jtsternberg "jtsternberg (38 commits)")[![JayWood](https://avatars.githubusercontent.com/u/2303074?v=4)](https://github.com/JayWood "JayWood (17 commits)")[![davidshq](https://avatars.githubusercontent.com/u/8009774?v=4)](https://github.com/davidshq "davidshq (2 commits)")[![gregrickaby](https://avatars.githubusercontent.com/u/200280?v=4)](https://github.com/gregrickaby "gregrickaby (1 commits)")

---

Tags

jsonwordpresswp-api

### Embed Badge

![Health badge](/badges/webdevstudios-wds-shortcodes/health.svg)

```
[![Health](https://phpackages.com/badges/webdevstudios-wds-shortcodes/health.svg)](https://phpackages.com/packages/webdevstudios-wds-shortcodes)
```

###  Alternatives

[justinrainbow/json-schema

A library to validate a json schema.

3.6k316.9M606](/packages/justinrainbow-json-schema)[airesvsg/acf-to-rest-api

Exposes Advanced Custom Fields Endpoints in the WordPress REST API

1.4k75.0k](/packages/airesvsg-acf-to-rest-api)[ergebnis/json-normalizer

Provides generic and vendor-specific normalizers for normalizing JSON documents.

8237.5M6](/packages/ergebnis-json-normalizer)[mwdelaney/sage-advanced-custom-fields

Advanced Custom Fields local JSON setup for Sage 9 based themes

104194.7k](/packages/mwdelaney-sage-advanced-custom-fields)[wpreadme2markdown/wpreadme2markdown

Convert WordPress Plugin readme.txt to Markdown

9564.6k4](/packages/wpreadme2markdown-wpreadme2markdown)[nekojira/wp-api-menus

Extends WordPress WP API with menu routes.

1401.5k](/packages/nekojira-wp-api-menus)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
