Automattic/Co-Authors-Plus
Stars: 275
Forks: 201
Pull Requests: 528
Issues: 468
Watchers: 131
Last Updated: 2023-09-15 18:14:01
Multiple bylines and Guest Authors for WordPress
License: GNU General Public License v2.0
Languages: Shell, CSS, PHP, JavaScript, Makefile, Gherkin
Co-Authors Plus
Stable tag: 3.5.15
Requires at least: 4.1
Tested up to: 6.3
Requires PHP: 5.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: authors, users, multiple authors, co-authors, multi-author, publishing
Contributors: batmoo, danielbachhuber, automattic, GaryJ
Assign multiple bylines to posts, pages, and custom post types with a search-as-you-type input box.
Description
Assign multiple bylines to posts, pages, and custom post types via a search-as-you-type input box. Co-authored posts appear on a co-author's archive page and in their feed. Co-authors may edit the posts they are associated with, and co-authors who are contributors may only edit posts if they have not been published (as is core behavior).
Add writers as bylines without creating WordPress user accounts. Simply create a guest author profile for the writer and assign the byline as you normally would.
On the frontend, use the Co-Authors Plus template tags to list co-authors anywhere you'd normally list the author.
This plugin is an almost complete rewrite of the Co-Authors plugin originally developed by Weston Ruter (2007). The original plugin was inspired by the 'Multiple Authors' plugin by Mark Jaquith (2005).
Refer to our wiki for detailed documentation.
Installation
- IMPORTANT: If you are using the original Co-Authors plugin, disable it before installing Co-Authors Plus.
- Extract the coauthors-plus.zip file and upload its contents to the
/wp-content/plugins/directory. Alternately, you can install directly from the Plugin directory within your WordPress Install. - Activate the plugin through the "Plugins" menu in WordPress.
- Place co-authors template tags in your template.
- Add co-authors to your posts and pages.
Screenshots
- Multiple authors can be added to a Post, Page, or Custom Post Type using an auto-complete interface.
- Guest authors allow you to assign bylines without creating WordPress user accounts. You can also override existing WordPress account meta by mapping a guest author to a WordPress user.
Frequently Asked Questions
How do I add Co-Authors Plus support to my theme?
If you've just installed Co-Authors Plus, you might notice that the bylines are being added in the backend but aren't appearing on the front end. You'll need to add the template tags to your theme before the bylines will appear.
What happens to posts and pages when I delete a user assigned to a post or page as a co-author?
When a user is deleted from WordPress, they will be removed from all posts for which they are co-authors. If you reassign their posts to another user, that user will be the co-author instead.
Can I use Co-Authors Plus with WordPress multisite?
Yes! Co-Authors Plus can be activated on a site-by-site basis or network-activated. If you create guest authors, however, those guest authors will exist on a site-by-site basis.
Who needs permission to do what?
A WordPress user will need the edit_others_posts capability to assign co-authors to posts. This is typically granted to the Editor role but can be altered with the coauthors_plus_edit_authors filter.
A WordPress user will need the list_users capability to create new guest author profiles. This is typically granted to the Administrator role but can be altered with the coauthors_guest_author_manage_cap filter.
Can I easily create a list of all co-authors?
Yes! A template tag called coauthors_wp_list_authors() accepts many of the same arguments as wp_list_authors(). Look in template-tags.php for more details.
Can I disable Guest Authors?
Yes! Guest authors can be disabled entirely through a filter. Having the following line load on init will do the trick:
add_filter( 'coauthors_guest_authors_enabled', '__return_false' )
Change Log
OPEN ISSUES
See all- Slug management for guest authors by @danielbachhuber
- Filter for the values that appear in auto-suggest search by @danielbachhuber
- Create new user or guest author while assigning to a post by @danielbachhuber
- Prevent Infinite Loops by @mjangda
- Explain neat filters in FAQ by @danielbachhuber
- Rewrite permissions to use map meta cap by @danielbachhuber
- Code Snippet: Allow authors to change co-authors by @danielbachhuber
- Consider making 'guest-authors' CPT private by @danielbachhuber
- Show alert if guest author profile has thumbnail and is missing an email address by @danielbachhuber
- Mapped guest author ignored if post is missing 'author' terms by @danielbachhuber
- Reduce dependency on action_init_late by @cfg
- Add support for Atom feeds by @nickdaugherty
- current_user_can( 'edit_others_posts' ) returns true for author and contributors while called in some contexts. by @natebot
- Bug in coauthors_plus->search_authors() by @dpacmittal
- Permit authorship "roles" to be specified on a post by post basis by @danielbachhuber
- Permit customization of the `/author/` URI segment for guest authors by @danielbachhuber
- Documentation: Change default capability for modifying authors by @danielbachhuber
- Steal GigaOm's fancy author queries by @danielbachhuber
- Filters for the_author() and the_author_posts_link() do not work by @jonatansteller
- Cannot remove the last author once post is saved by @paulschreiber
- Replace wp_die errors with WordPress UI error messages. by @ryanmarkel
- filter_count_user_posts not running on get_usernumposts filter by @MrVibe
- Ajax suggest metabox shows 0 results frequent by @dpacmittal
- Javascript Implementation for the Author Box on a post loads Gravatar would like to support WP Avatar or BP Avatar by @garretthyder
- Add twitter field to be compatible with Yoast seo fields added to User admin pages by @nine-2-five
- WP-API Endpoints by @BrekiTomasson
- Imported guest-author posts differing only in post_date should not be duplicated by @mattoperry
- trying to get property on non-bject by @nicgirault
- Biographical Info field on contributors profile is double-encoded by @paulschreiber
- Pending: Flag reassignment on delete for non-primary coauthors (not the post_authors) by @garretthyder
- AMP author template overriding the theme by @bcampeau
- Problem with query on wordpress 4.6.1 by @RoccoMarco
- Update to select2 4.x by @paulschreiber
- Inline docs for all functions, hooks by @philipjohn
- Separate out some functions by @philipjohn
- Feature request: bulk deletion of guest authors and reassignment by @benlk
- Drop the custom `wp_notify_postauthor` function by @mjangda
- Add Custom Post Type Column to Guest Author User Lists by @devrahul
- wp_notify_postauthor() doesn't notify authors in some situations by @mallorydxw
- add_coauthors() deleting old users if user_login is email address by @yomisimie
- Problem creating guest author page when multiple guest authors are present in last post by @xpander001
- Can't list co-author articles by @lohic
- In WordPress > 4.9.1, co-authors do not save correctly by @benlk
- Missing "author" in Google Search Console by @hellor0bot
- WP_Query ID arg not working with other plugins when Co-Authors-Plus is active by @paoga87
- test__author_queried_object_fix doesn't need to initialise wp_rewrite by @SeanDS
- "Trying to get property of non-object" warning in class-coauthors-wp-list-table.php by @paulschreiber
- Missing post count in "Mine" view for coauthor by @TheCrowned
- Include a uninstall routine by @TheCrowned
- CAP removes the Author field in bulk edit actions by @TheCrowned
- WP_CLI create-guest-authors creates profiles for ALL users by @TheCrowned
- Create post terms on install by @TheCrowned
- Migrate author terms from `$username` to `cap-$username` by @TheCrowned
- Some author pages empty for some logged in users by @jtbayly
- Guest Author Descriptions template tag by @TheCrowned
- Change post_author to Guest Author linked account, if any by @TheCrowned
- Mismatch between different post counting methods by @TheCrowned
- Failing tests in master by @TheCrowned
- Plugin shows that author has posts when all posts are in trash by @florianbrinkmann
- Improve documentation for WP-CLI commands by @GaryJones
- Issue with 'coauthors_guest_authors_force' by @jrupan
- Gutenberg does not use the remove_meta_box command by @jonathanstegall
- Multiple undefined indexes during csv import by @WPprodigy
- Support Elasticsearch powered WP Queries by @WPprodigy
- Docs on wp.org plugin listing have outdated screenshots by @benlk
- Add posts in Mine by @alexdobsom
- plugin conflicts with custom taxonomy archive page titles by @pjeaje
- Wrong user description showing on Author archive by @robmaurizi
- Guarantee that $wp_query->queried_object_id is an integer by @Biont
- If certain characters exist in the name, display_name is set to empty string by @subrato30
- Deleting main author and assigning post to new author removes co-authors by @Lumrenion
- Cannot add an author with a one character long name by @mallorydxw
- GitHub repo lacks community guidelines by @benlk
- Refresh meta box nonce after re-authenticating to prevent data loss by @hrkhal
- Can't set authors by @quedicesebas
- Get all posts from a coauthor using WP REST API by @gtso86
- Add bulk actions (delete, …) to list screen by @paulschreiber
- CLI command to delete guest authors by @paulschreiber
- Ability to edit/update slug by @paulschreiber
- Widget to show other posts by co-authors by @vikasrawal
- Trying to get property 'user_nicename' of non-object (with Yoast SEO) by @benoitchantre
- 302 redirect to /404 for non-existent paged Author archive by @kclarke10
- Integrate with Yoast's new Schema API by @WPprodigy
- Impossible to Reassign Posts to a Guest Author by @MadtownLems
- Selecting an author does not populate the form field by @scofennell
- Conditionally allow for debugging by @emrikol
- Bylines are correct but articles don't show on author page by @jxxe
- Can't assign posts to Guest Author during Import by @MadtownLems
- get_guest_author_post_count never returns zero by @jonathanstegall
- Jetpack subscription email shows posts authored by default author, not guest author by @ckoerner
- Edit author slug support for Co author plus by @Peterr-K
- Incorrect post count when linked accounts are authors of the same post prior to linking by @nielslange
- Incorrect user post count when guest account is not linked by @nielslange
- Fix author page when Guest Author slug overlaps with WP Admin user by @tmmbecker
- Feature Request: Rich Text / WYSIWYG for Biographical Info by @MadtownLems
- AutoComplete Box shows URL of Avatar instead of actual Avatar by @MadtownLems
- Filter Ajax Suggested Authors by @anthonythorne
- Ajax Suggested Authors return format by @anthonythorne
- Add a link to byline avatar/logo by @rpelletierrefocus
- Pronouns in author info by @eecoston
- Preselect Guest Users when new post is created by @jaspindersingh91ie
- Potential cache issue with ajax search on admin by @jonathanstegall
- Post featured image/thumbnail size is being used for avatars by @manudavidos
- Possible to start a new post with no selected author by @jonathanstegall
- The Author Page and WP Posts Shows 0 Entries with Plugin Enabled! by @saadirfan
- Show authors outside loop by @zigots007
- Guest Authors do not appear as authors in "Latest Posts" block by @ckoerner
- Cannot add users in WPML second language on posts by @smatic
- The filter filter_count_user_posts() does not return the post count of custom post-types by @IIM-Arvid
- Not sanitized input variable and non-strict comparison by @rickhurst
- `post_author` not updated properly if assigning a new WP user by @dkoo
- Missing Archive Title, Description for Guest Authors on author archive pages by @laurelfulford
- Authors block is missing in the post after upgrading from v3.4.3 to 3.5.x by @deshetti
- Guest Author Not Saving on Draft Posts after 3.5.8 update by @mjonasftc
- CAP does not filter the byline that is output for posts via oEmbed; oEmbed consumers show the wrong byline by @benlk
RELEASES
See all- 3.5.6 by @rebeccahum
- 3.5.5 by @rebeccahum
- 3.5.4 by @rebeccahum
- 3.5.3 by @rebeccahum
- 3.5.2 by @lschuyler
- 3.5.1 by @lschuyler
- 3.5 by @rebeccahum
- 3.4.92 by @rebeccahum
- 3.4.91 by @rebeccahum
- 3.4.9 by @rebeccahum
- 3.4.8 by @rebeccahum
- 3.4.7 by @rebeccahum
- 3.4.6 by @rebeccahum
- 3.4.5 by @rebeccahum
- 3.4.4 by @rebeccahum
- 3.4.3 by @rebeccahum
- 3.4.2 by @rebeccahum
- 3.4 by @rebeccahum
- 3.3.1 ("Gutentag") by @mjangda
- 3.3.0 by @philipjohn
- 3.3-beta by @philipjohn
- 3.2.2 by @philipjohn
- 3.2 by @philipjohn
- by @mattoperry
- 3.5.15 by @GaryJones
- 3.5.14 by @GaryJones
- 3.5.13 by @GaryJones
- 3.5.12 by @GaryJones
- 3.5.11 by @GaryJones
- 3.5.10 by @leogermani
- 3.5.9 by @leogermani
- 3.5.8 by @rebeccahum
- 3.5.7 by @rebeccahum