# Postcollab Toolkit

**Contributors:** kmangukiya
**Requires at least:** 5.2
**Tested up to:** 6.9
**Requires PHP:** 8.2 
**Version:** 1.0.0
**Stable tag:** 1.0.0
**License:** GPLv2 or later
**License URI:** [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html)

Add a Contributors metabox to posts and display multiple contributors on the front end.

## Description

**Postcollab Toolkit** allows you to assign multiple contributors to a WordPress post in addition to the main author.

Editors can select contributors from registered users directly from the post editor. Selected contributors are automatically displayed on the front end with their Gravatars and links to their author archive pages.

The plugin is lightweight, developer-friendly, and follows WordPress coding standards.

## Features

* Assign multiple contributors to a post
* Contributors metabox in the post editor
* Automatically display contributors below post content
* Show contributor Gravatar and author link
* Extendable using WordPress hooks and filters
* Clean and lightweight implementation

## Installation

1. Upload the `postcollab-toolkit` folder to the `/wp-content/plugins/` directory, or install it via the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Edit any post and select contributors from the **Contributors** metabox.

## Usage

1. Go to **Posts → Add New** or **Edit Post**.
2. Find the **Contributors** metabox in the editor.
3. Select one or more users.
4. Save or update the post.

The selected contributors will appear at the bottom of the post on the front end.

## Frequently Asked Questions

### Can I add more than one contributor to a post?

Yes. You can select multiple users as contributors from the Contributors metabox.

### Does this plugin change the main post author?

No. The original post author remains unchanged. Contributors are displayed separately.

## Screenshots

1. Contributors metabox in the post editor
2. Selecting multiple contributors
3. Contributors displayed on the front end below post content

## Hooks

### Filters

* `wpcb_get_metabox_contributors`
  Modify the list of users shown in the Contributors metabox.

* `wpcb_pre_save_contributors_ids`
  Filter contributor IDs before saving.

* `wpcb_get_contributors_ids`
  Filter contributor IDs before displaying on the front end.

* `wpcb_contributors_list_template`
  Override the template used to display contributors.

### Actions

* `wpcb_after_contributors_saved`
  Fires after contributors are saved to post meta.

## Changelog

### 1.0.0

* Initial release
* Added Contributors metabox to post editor
* Display contributors on the front end
* Included hooks and filters for customization

## Upgrade Notice

### 1.0.0

Initial release of Postcollab Toolkit.


## License

This plugin is licensed under the **GNU General Public License v2.0 or later**.
[https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html)