From 79944b93263ba1fcddba22a858660c6449032ecb Mon Sep 17 00:00:00 2001 From: George Mamadashvili Date: Tue, 29 Jul 2025 14:59:50 +0400 Subject: [PATCH 1/2] Social: Document guidelines and extensibility --- .../block-library/src/social-link/README.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 packages/block-library/src/social-link/README.md diff --git a/packages/block-library/src/social-link/README.md b/packages/block-library/src/social-link/README.md new file mode 100644 index 00000000000000..77381ec21edbe4 --- /dev/null +++ b/packages/block-library/src/social-link/README.md @@ -0,0 +1,21 @@ +# Social Icon block + +The Social Icon is a foundational block that displays various icons linking to different social profiles or sites. Each social service is registered as a variation of this block. + + +## Adding new social icons + +The core maintains certain standards for social icons. To add a new one to the existing variations, it must be a well-established, popular, and mainstream service. + +When considering establishment and popularity, several factors should be evaluated, such as: + +* Is the service popular enough for core developers to have heard of it before? Is it "mainstream?" +* How old is the service? +* Does it have a well-established Wikipedia article? (Seriously.) +* Has anyone written a WordPress plugin that already adds it as a block variation? Do these plugins have any noticeable adoption or traction that would indicate usage and demand? +* Is this social service frequently requested? + + +## Adding custom social icons + +Starting from WordPress 6.9, it's possible to add custom social icons to your site. Here's an example plugin: https://github.com/wptrainingteam/devblog-custom-social-icons. From 1324a6a11b7cb96da0a9fe9c0bbfc42c0a87b83b Mon Sep 17 00:00:00 2001 From: George Mamadashvili Date: Wed, 30 Jul 2025 08:39:46 +0400 Subject: [PATCH 2/2] Feedback --- packages/block-library/src/social-link/README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/packages/block-library/src/social-link/README.md b/packages/block-library/src/social-link/README.md index 77381ec21edbe4..730bfdaa3cd448 100644 --- a/packages/block-library/src/social-link/README.md +++ b/packages/block-library/src/social-link/README.md @@ -5,17 +5,17 @@ The Social Icon is a foundational block that displays various icons linking to d ## Adding new social icons -The core maintains certain standards for social icons. To add a new one to the existing variations, it must be a well-established, popular, and mainstream service. +The core maintains certain standards for adding new social icons. To add a new variation to WordPress, it must be well-established and popular. -When considering establishment and popularity, several factors should be evaluated, such as: +To evaluate if a social service should be added, contributors will consider the following factors: * Is the service popular enough for core developers to have heard of it before? Is it "mainstream?" -* How old is the service? -* Does it have a well-established Wikipedia article? (Seriously.) -* Has anyone written a WordPress plugin that already adds it as a block variation? Do these plugins have any noticeable adoption or traction that would indicate usage and demand? +* How long has the service been online? +* Does it have a Wikipedia article? +* Is there a plugin adding social icons in the repository that includes the services in question and has a considerable number of active installations? * Is this social service frequently requested? ## Adding custom social icons -Starting from WordPress 6.9, it's possible to add custom social icons to your site. Here's an example plugin: https://github.com/wptrainingteam/devblog-custom-social-icons. +Starting from WordPress 6.9, it's possible to add custom social icons to your site. See: [#70261](https://github.com/WordPress/gutenberg/pull/70261).