[إقرأ بالعربي](https://github.com/shadigaafar/musahimoun/blob/main/README.ar.md)

## Musahimoun – Multiple Authors, Guest Authors & Contributors for WordPress Block Themes (Full Site Editing)

**Description:**

This plugin allows you to seamlessly add guest authors or contributors to your WordPress posts, specifically within block themes (Full Site Editing). Guest authors/contributors created with this plugin function identically to regular user authors, complete with dedicated archive pages showcasing all their content.

**Features:**

- **Effortless Guest Contributor Integration:** Add guest authors/contributors to your posts without creating user accounts. They'll function just like regular authors.
- **Dedicated Author Archives:** Each guest author will have their own archive page displaying all their published posts.
- **Multiple Post Guest Author or Contributor Support:** Have a variety of guest authors/contributors? No problem! This plugin allows for the addition of multiple guest authors/contributors.
  **Multiple Roles Support:** Have a variety of post contributtor (author, fact-checker, etc)? No problem! This plugin allows for the assingment of multiple roles for contributors.
- **Ability to support any post type:** You can chose which post type to add this feature to.
- **One click migratiion from PublisherPress Authors:** You can migrate on one click. Migration from other plugins will be included in new releases soon.

**New Features:**

- **Social Links:** Assign social links to any contributor, real user or guest.
- **More Fields:** You can now add "Website", "First name", "Last Name" to guest contributors.

**Important Note:**

This plugin is specifically designed for WordPress block themes (Full Site Editing). It will not work for traditional WordPress themes.

**Installation**

1. Upload the plugin files to the `/wp-content/plugins/musahimoun` directory, or install the plugin through the WordPress plugins screen directly.
1. Activate the plugin through the 'Plugins' screen in WordPress
1. Use the Musahimoun menu settings to configure the plugin
1. go to appearance->editor and use the blocks provided by this plugin instead of WordPress default ones, you can use them in any post single template or author archive template.
1. All blocks must be wrapped by "Musahimoun: contributor query loop" block then by "Musahimoun: role assingment query loop".

**Other**

You can use the `mshmn_all_post_author_names` custom field (post meta) to retrieve all primary authors or contributors assigned under the default role.
A common use case is when you want to define a custom schema.org configuration for a post type, and want to set the post author attribute.

**Contribute to Development**
See [DEVELOPER.md](https://github.com/shadigaafar/musahimoun/blob/main/docs/DEVELOPER.md).