WP Contributions

Description

Provides an easy way to display your WordPress.org Themes, Plugins, Core tickets, and Codex contributions with handy widgets and template tags.

WordPress wouldn’t be as amazing as it is without all of the contributors to the project. The community is proud of each and every contributor. Display some of your contributions to the project using handy widgets or template tags in your custom theme. Currently, you can display your contributions to WordPress core, the WordPress Codex, your WordPress Plugins, or your WordPress themes.

There are four handy widgets available for you that are easily configured and added to your sidebar. You just need to add your theme or plugin slug to display a theme or plugin or enter your WordPress.org username to display core or codex contributions.

There are two shortcodes available, and some handy template tags if you desire to add them in your custom theme. More info on shortcodes and template tags are available under the FAQ.

We want to give a big thanks to the great plugin, Core Contributions Widget by Eric Mann, Michael Fields, John P. Bloch, Mike Bijon, and Konstantin Obenland. We forked part of this plugin to include Core and Codex Contributions. If you would just like widgets to display Core and Codex Contributions, we recommend downloading their plugin.

Available shortcodes

Show a Plugin Card

[wp_contributions_plugin_card slug="your-plugin-slug"]<h3>Show a Theme Card</h3>
[wp_contributions_theme_card slug="your-theme-slug"]

Not sure what shortcodes are? Learn more here.

How do I add a widget?

  1. Visit Appearance -> Widgets in your WordPress Admin.
  2. Drag any of the WP Contributions widgets to the sidebar where you want them to appear.
  3. For the plugin and them widgets, enter a widget title and enter the slug of the plugin you would like to display. The slug of a plugin can be found by looking at the URL of the plugin page. For instance, Jetpack is found at https://wordpress.org/plugins/jetpack/ which makes the plugin slug jetpack.
  4. For Core and Codex contributions, enter a title, your WordPress.org username, and the number of contributions you would like to display. It will display the most recent contributions. There will be a link to display more contributions so people can view any after the number you input.

What template tags are available?

<?php wp_contributions_plugin_card( $plugin_slug ); ?>

Displays a the plugin information for a plugin. Just pass the slug of the plugin as $plugin_slug to display the plugin information card. This function will echo your results to your template.

<?php wp_contributions_theme_card( $theme_slug ); ?>

Displays a the theme information for a theme. Just pass the slug of the theme as $theme_slug to display the theme information card. This function will echo your results to your template.

<?php wp_contributions_author_plugin_cards( $username ); ?>

Displays all plugins for a plugin author. Just pass the WordPress.org username as $username to display all plugin cards for that user. This function will echo your results to your template.

<?php wp_contributions_author_theme_cards( $username ); ?>

Displays all plugins for a theme author. Just pass the WordPress.org username as $username to display all theme cards for that user. This function will echo your results to your template.

<?php wp_contributions_core_contributions_card( $username, $count ); ?>

Displays Core contributions for a WordPress.org user. Just pass the WordPress.org username as $username to display the contributions for that user. Optionally, you can also pass in $count to control the number of contributions to display. Default count is set at 5. This function will echo your results to your template.

<?php wp_contributions_codex_contributions_card( $username, $count ); ?>

Displays Codex contributions for a WordPress.org user. Just pass the WordPress.org username as $username to display the contributions for that user. Optionally, you can also pass in $count to control the number of contributions to display. Default count is set at 5. This function will echo your results to your template.

How do I integrate directly in a theme?

Copy either the individual template file: e.g. /wp-content/wp-contributions-theme-card-template.php, or the plugin’s entire template folder into your theme’s folder (/wp-content/plugins/wp-contributions/templates/), and override anything you desire.

Screenshots

  • Plugin Card View (Shown in Twenty Fourteen Theme)
  • Theme Card View (Shown in in Twenty Fourteen Theme)
  • Codex Contributions Card View (Shown in Twenty Fourteen Theme)
  • Core Contributions Card View (Shown in Twenty Fourteen Theme)
  • Widget Management

Blocks

This plugin provides 1 block.

  • WP Contributions Block Wordpress Contributions Showcase made easy.

Installation

  1. Upload the wp-contributions folder to the /wp-content/plugins/ directory.
  2. Activate the WP Contributions plugin through the ‘Plugins’ menu in WordPress.
  3. Add widgets to your sidebars or place template tags in your templates.

Reviews

awgust 19, 2024
It’s a small plugin, but exactly what I needed and the support is great, even almost nobody has it installed (if we believe the numbers). Thank you!
Read all 1 review

Contributors & Developers

“WP Contributions” is open source software. The following people have contributed to this plugin.

Contributors

“WP Contributions” has been translated into 5 locales. Thank you to the translators for their contributions.

Translate “WP Contributions” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.3.1

  • Updated: Confirmed compatibility with WP 6.6.1

1.3.0

  • Updated: Block styles in editor.
  • Updated: Improved coding standards and cleaned up PHP warnings/notices.
  • Updated: Internal build tools.

1.2.1

  • Ownership transition.

1.2.0

  • Added: WordPress Block for Themes, Plugins, Core, and Codex contributions.
  • Fixed: Minor CSS issues.
  • Fixed: Fatal errors when computer had no internet connectivity.
  • Fixed: Errors regarding parsing strings as XML.

1.1.0

  • Shortcodes for:
    • Plugin Card [wp_contributions_plugin_card slug="your-plugin-slug"], and
    • Theme Card [wp_contributions_theme_card slug="your-theme-slug"]
  • Add descriptions to Core widget

1.0.1

  • minor edits and updates to Grunt build

1.0.0

  • Initial Release