@automattic/newspack-blocks 1.0.0-hotfix-cap-count-user-posts-dedup.1

package/src/blocks/author-list/view.php

@@ -0,0 +1,180 @@
+<?php
+/**
+ * Server-side render functions for the Author List block.
+ *
+ * @package WordPress
+ */
+
+/**
+ * Dynamic block registration.
+ */
+function newspack_blocks_register_author_list() {
+	$block_json = json_decode(
+		file_get_contents( __DIR__ . '/block.json' ), // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
+		true
+	);
+
+	if ( class_exists( '\Newspack\Authors_Custom_Fields' ) ) {
+		$author_custom_fields = \Newspack\Authors_Custom_Fields::get_custom_fields();
+		foreach ( $author_custom_fields as $field ) {
+			$block_json['attributes'][ 'show' . $field['name'] ] = [
+				'type'    => 'boolean',
+				'default' => true,
+			];
+		}
+	}
+
+	register_block_type(
+		'newspack-blocks/' . $block_json['name'],
+		[
+			'api_version'     => $block_json['apiVersion'],
+			'attributes'      => $block_json['attributes'],
+			'render_callback' => 'newspack_blocks_render_block_author_list',
+		]
+	);
+}
+
+/**
+ * Block render callback.
+ *
+ * @param array $attributes Block attributes.
+ */
+function newspack_blocks_render_block_author_list( $attributes ) {
+	if ( ! class_exists( 'WP_REST_Newspack_Author_List_Controller' ) ) {
+		return;
+	}
+
+	// Gather attributes.
+	$exclude_empty       = $attributes['excludeEmpty'];
+	$author_roles        = $attributes['authorRoles'];
+	$author_type         = $attributes['authorType'];
+	$is_columns          = 'columns' === $attributes['layout'];
+	$number_of_columns   = $attributes['columns'];
+	$show_separators     = $attributes['showSeparators'];
+	$separator_sections  = $attributes['separatorSections'];
+	$avatar_hide_default = $attributes['avatarHideDefault'];
+	$params              = [
+		'author_type'  => $author_type,
+		'author_roles' => $author_roles,
+		'exclude'      => $attributes['exclude'], // phpcs:ignore WordPressVIPMinimum.Performance.WPQueryParams.PostNotIn_exclude
+		'fields'       => [ 'id', 'name', 'bio', 'email', 'social', 'avatar', 'url' ],
+	];
+
+	if ( $exclude_empty ) {
+		$params['exclude_empty'] = true;
+	}
+
+	if ( $avatar_hide_default ) {
+		$params['avatar_hide_default'] = true;
+	}
+
+	$author_list_controller = new WP_REST_Newspack_Author_List_Controller();
+	$authors                = $author_list_controller->get_all_authors( $params );
+
+	$anchor_id = uniqid();
+
+	if ( empty( $authors ) ) {
+		return;
+	}
+
+	// Enqueue required front-end assets.
+	Newspack_Blocks::enqueue_view_assets( 'author-list' );
+	Newspack_Blocks::enqueue_view_assets( 'author-profile' );
+
+	// Class names for the list container.
+	$container_classes = [ 'newspack-blocks__author-list-container' ];
+	if ( $is_columns ) {
+		$container_classes[] = 'is-columns';
+		$container_classes[] = 'columns-' . (string) $number_of_columns;
+	}
+
+	ob_start();
+	?>
+	<div class="wp-block-newspack-blocks-author-list <?php echo esc_attr( $attributes['className'] ); ?>">
+
+	<?php
+	// Columns WITH alphabetical separator sections.
+	if ( $is_columns && $show_separators && $separator_sections ) :
+		// Associative array to store authors chunked by alphabet, if separatorSections is true.
+		$chunked_authors = [];
+		foreach ( $authors as $author ) {
+			$first_letter = strtoupper( substr( $author['last_name'], 0, 1 ) );
+			if ( ! isset( $chunked_authors[ $first_letter ] ) ) {
+				$chunked_authors[ $first_letter ] = [];
+			}
+			$chunked_authors[ $first_letter ][] = $author;
+		}
+
+		foreach ( $chunked_authors as $separator_letter => $separator_authors ) :
+			?>
+			<h2
+				class="newspack-blocks__author-list-separator"
+				id="newspack-blocks__author-list-separator__<?php echo esc_attr( $anchor_id ); ?>__<?php echo esc_attr( $separator_letter ); ?>"
+			>
+				<?php echo esc_html( $separator_letter ); ?>
+			</h2>
+			<ul class="<?php echo esc_attr( implode( ' ', $container_classes ) ); ?>">
+				<?php
+				foreach ( $separator_authors as $author ) :
+					$author_card = Newspack_Blocks::template_include(
+						'author-profile-card',
+						[
+							'attributes' => $attributes,
+							'author'     => $author,
+						]
+					);
+					?>
+					<li class="newspack-blocks__author-list-item">
+						<?php echo $author_card; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
+					</li>
+				<?php endforeach; ?>
+			</ul>
+		<?php endforeach; ?>
+		<?php
+		// List view or columns without alphabetical separator sections.
+	else :
+		$separators = [];
+		?>
+
+		<ul class="<?php echo esc_attr( implode( ' ', $container_classes ) ); ?>">
+			<?php
+			foreach ( $authors as $author ) :
+				$first_letter   = strtoupper( substr( $author['last_name'], 0, 1 ) );
+				$show_separator = ! in_array( $first_letter, $separators, true );
+
+				if ( $show_separator ) {
+					$separators[] = $first_letter;
+				}
+
+				$author_card = Newspack_Blocks::template_include(
+					'author-profile-card',
+					[
+						'attributes' => $attributes,
+						'author'     => $author,
+					]
+				);
+
+				if ( $show_separators && $show_separator ) :
+					?>
+					<li class="newspack-blocks__author-list-item">
+						<h2
+							class="newspack-blocks__author-list-separator"
+							id="newspack-blocks__author-list-separator__<?php echo esc_attr( $anchor_id ); ?>__<?php echo esc_attr( $first_letter ); ?>"
+						>
+							<?php echo esc_html( $first_letter ); ?>
+						</h2>
+					</li>
+				<?php endif; ?>
+				<li class="newspack-blocks__author-list-item">
+					<?php echo $author_card; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
+				</li>
+			<?php endforeach; ?>
+		</ul>
+	<?php endif; ?>
+	</div>
+	<?php
+
+	return ob_get_clean();
+}
+
+add_action( 'init', 'newspack_blocks_register_author_list' );

package/src/blocks/author-list/view.scss

@@ -0,0 +1,46 @@
+.wp-block-newspack-blocks-author-list {
+	.newspack-blocks__author-list-container {
+		list-style: none;
+		margin-left: 0;
+		margin-right: 0;
+		padding-left: 0;
+		padding-right: 0;
+
+		.newspack-blocks__author-list-item {
+			display: inline-block;
+			margin-bottom: 2.5rem;
+			width: 100%;
+		}
+	}
+
+	.is-columns {
+		column-width: auto;
+		page-break-inside: avoid;
+		break-inside: avoid;
+	}
+
+	.columns-2 {
+		column-count: 2;
+	}
+
+	.columns-3 {
+		column-count: 3;
+	}
+
+	.columns-4 {
+		column-count: 4;
+	}
+
+	.columns-5 {
+		column-count: 5;
+	}
+
+	.columns-6 {
+		column-count: 6;
+	}
+
+	h2.newspack-blocks__author-list-separator {
+		margin-bottom: 0;
+		margin-top: 0;
+	}
+}

package/src/blocks/author-profile/README.md

@@ -0,0 +1,105 @@
+# Author Profile Block
+
+A Gutenberg block that displays author bio cards with support for multiple authorship systems and two rendering modes.
+
+## Overview
+
+The Author Profile block renders a complete author profile, including name, avatar, biography, social links, and a link to their archive page. It supports two operating modes (contextual and specific) and two rendering modes (nested and flat), adapting automatically to the theme type.
+
+## Operating modes
+
+### Contextual mode
+
+Automatically detects authors for the current post. Resolution priority:
+
+1. **Newspack Custom Bylines:** If `_newspack_byline_active` meta is set and the byline contains `[Author id="X"]` shortcodes, profiles are shown for those authors. Plain-text-only bylines suppress the block entirely.
+2. **CoAuthors Plus:** If CAP is active, all co-authors are displayed (WordPress users and Guest Authors).
+3. **Default WordPress author:** Falls back to the standard post author.
+
+### Specific mode
+
+Displays a single author selected via a search/autocomplete interface. The selected author ID and guest author flag are stored as block attributes.
+
+## Rendering modes
+
+### Nested mode (layoutVersion 2)
+
+Used in block themes. The block saves `<InnerBlocks.Content />` and composes the profile from core blocks (Columns, Group, Heading, Paragraph) plus [`newspack/avatar`](https://github.com/Automattic/newspack-plugin/tree/trunk/src/blocks/avatar) and [`newspack/author-profile-social`](https://github.com/Automattic/newspack-plugin/tree/trunk/src/blocks/author-profile-social). Author data is injected via WordPress block bindings (`newspack-blocks/author` source) and block context.
+
+**Layout variations:**
+
+| Variation | Template constant | Description |
+|-----------|------------------|-------------|
+| `avatar-left` | `AVATAR_LEFT_TEMPLATE` | Two-column: avatar left, content right |
+| `avatar-right` | `AVATAR_RIGHT_TEMPLATE` | Two-column: content left, avatar right |
+| `centered` | `CENTERED_TEMPLATE` | Flex group: centered avatar, centered text |
+| `compact` | `COMPACT_TEMPLATE` | Flex group: no avatar, vertical stack |
+
+Variations are defined in [variations.js](./variations.js) and templates in [templates.js](./templates.js).
+
+### Flat mode (layoutVersion 1)
+
+Used in classic themes. The block returns `save: () => null` and renders entirely via PHP using the [author-profile-card.php](../../templates/author-profile-card.php) template.
+
+**Mode selection logic:** New blocks in block themes automatically get `layoutVersion: 2`. Existing blocks preserve their saved mode. A v2 block opened in a classic theme shows a warning in the editor and falls back to flat rendering on the frontend.
+
+## Block attributes
+
+### Core attributes
+
+| Attribute | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `authorId` | number | `0` | Selected author ID (specific mode) |
+| `isContextual` | boolean | `false` | Whether to auto-detect authors from post context |
+| `isGuestAuthor` | boolean | `true` | Whether the selected author is a CAP guest author |
+| `layoutVersion` | number | `1` | `1` = flat, `2` = nested (see Rendering modes) |
+| `variation` | string | `""` | Active layout variation name |
+| `showEmptyBio` | boolean | `true` | Show profiles for authors without bios |
+| `avatarHideDefault` | boolean | `false` | Hide default placeholder avatar |
+
+### Flat mode attributes
+
+These only apply in flat mode (`layoutVersion: 1`). In nested mode, display is controlled by adding or removing inner blocks.
+
+| Attribute | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `showBio` | boolean | `true` | Display biography |
+| `showSocial` | boolean | `true` | Display social links |
+| `showEmail` | boolean | `true` | Display email link |
+| `showArchiveLink` | boolean | `true` | Display "More by Author" link |
+| `showAvatar` | boolean | `true` | Display avatar |
+| `textSize` | string | `"medium"` | Text size: small, medium, large, extra-large |
+| `avatarAlignment` | string | `"left"` | Avatar position: left or right |
+| `avatarSize` | number | `128` | Avatar size in pixels |
+| `avatarBorderRadius` | string | `"50%"` | Avatar border radius |
+
+Additional `show*` attributes are dynamically added from Newspack Author Custom Fields when available (e.g., `shownewspack_job_title`, `shownewspack_role`, `shownewspack_employer`).
+
+## Block bindings
+
+The `newspack-blocks/author` binding source is registered in both PHP ([view.php](./view.php)) and JS ([edit.js](./edit.js)). Supported keys:
+
+| Key | Description |
+|-----|-------------|
+| `name` | Author display name |
+| `bio` | Author biography |
+| `url` / `archive_url` | Author archive URL |
+| `archive_link_text` | "More by Author Name" text |
+| `newspack_job_title` | Job title (custom field) |
+| `newspack_role` | Role (custom field) |
+| `newspack_employer` | Employer (custom field) |
+
+In the editor, bindings resolve via a per-instance author map (`window.__newspackAuthorsByBlock`) keyed by `clientId`, so multiple Author Profile blocks on the same page don't conflict.
+
+## Editor behavior
+
+- **Variation picker**: Shown when the block has no inner blocks (nested mode). Follows the same pattern as the core Columns block.
+- **Author context**: The [AuthorContext](./context.js) React context passes author data to inner blocks. It's also exposed globally as `window.NewspackAuthorContext` for cross-package use (e.g., by the avatar block in newspack-plugin).
+- **Template context**: In the Site Editor (templates/template parts), a placeholder author is shown with all supported social services populated.
+
+## Related
+
+- [Author Social Links Block](https://github.com/Automattic/newspack-plugin/tree/trunk/src/blocks/author-profile-social) - Inner block for social media icons.
+- [Avatar Block](https://github.com/Automattic/newspack-plugin/tree/trunk/src/blocks/avatar) - Inner block for author avatars.
+- [Author Profile Card Template](../../templates/author-profile-card.php) - PHP template for flat-mode rendering.
+- [Author List Block](../author-list/) - Directory-style author listing (different use case).

package/src/blocks/author-profile/block.json

@@ -0,0 +1,77 @@
+{
+	"$schema": "https://schemas.wp.org/trunk/block.json",
+	"apiVersion": 3,
+	"name": "author-profile",
+	"category": "newspack",
+	"usesContext": [ "postId", "postType" ],
+	"attributes": {
+		"className": {
+			"type": "string",
+			"default": ""
+		},
+		"authorId": {
+			"type": "number",
+			"default": 0
+		},
+		"isContextual": {
+			"type": "boolean",
+			"default": false
+		},
+		"layoutVersion": {
+			"type": "number",
+			"default": 1
+		},
+		"showEmptyBio": {
+			"type": "boolean",
+			"default": true
+		},
+		"isGuestAuthor": {
+			"type": "boolean",
+			"default": true
+		},
+		"showBio": {
+			"type": "boolean",
+			"default": true
+		},
+		"showSocial": {
+			"type": "boolean",
+			"default": true
+		},
+		"showEmail": {
+			"type": "boolean",
+			"default": true
+		},
+		"showArchiveLink": {
+			"type": "boolean",
+			"default": true
+		},
+		"textSize": {
+			"type": "string",
+			"default": "medium"
+		},
+		"showAvatar": {
+			"type": "boolean",
+			"default": true
+		},
+		"avatarAlignment": {
+			"type": "string",
+			"default": "left"
+		},
+		"avatarBorderRadius": {
+			"type": "string",
+			"default": "50%"
+		},
+		"avatarSize": {
+			"type": "number",
+			"default": 128
+		},
+		"avatarHideDefault": {
+			"type": "boolean",
+			"default": false
+		},
+		"variation": {
+			"type": "string",
+			"default": ""
+		}
+	}
+}