Docs: update links to work on DevHub

Author: kraftbj

composer.json

@@ -20,7 +20,9 @@
     },
     "scripts": {
         "docs-manifest": "php docs/bin/generate-manifest.php",
+        "docs-links": "php docs/bin/update-markdown-links.php",
         "docs": [
+            "@docs-links",
             "@docs-manifest"
         ]
     }

docs/bin/update-markdown-links.php

@@ -0,0 +1,46 @@
+#!/usr/bin/env php
+<?php
+/**
+ * Update markdown links to remove .md extensions and /index paths.
+ *
+ * @package wordpress/secure-custom-fields
+ */
+
+// phpcs:disable WordPress.WP.AlternativeFunctions -- Using native PHP functions as this is a CLI script.
+
+$root  = dirname( __DIR__ );
+$paths = array(
+	$root . '/*.md',
+	$root . '/*/*.md',
+	$root . '/*/*/*.md',
+	$root . '/*/*/*/*.md',
+);
+
+$updated_files = 0;
+$updated_links = 0;
+
+foreach ( $paths as $path_pattern ) {
+	foreach ( glob( $path_pattern ) as $file ) {
+		if ( basename( $file ) === 'README.md' || basename( $file ) === 'META.md' ) {
+			continue;
+		}
+
+		$content  = file_get_contents( $file );
+		$original = $content;
+
+		// Replace links ending in .md
+		$content = preg_replace( '/\]\(([^)]+)\.md\)/', ']($1)', $content );
+
+		// Replace links ending in /index
+		$content = preg_replace( '/\]\(([^)]+)\/index\)/', ']($1)', $content );
+
+		if ( $content !== $original ) {
+			file_put_contents( $file, $content );
+			++$updated_files;
+			$updated_links += substr_count( $original, '.md)' ) + substr_count( $original, '/index)' );
+		}
+	}
+}
+
+// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+printf( 'Updated %d links in %d files%s', $updated_links, $updated_files, PHP_EOL );

docs/concepts/index.md

@@ -4,8 +4,8 @@ This section covers the fundamental concepts and architecture of Secure Custom F
 
 ## In This Section
 
-- [Architecture](architecture.md) - Understanding SCF's internal structure
-- [Security](security.md) - Security principles and best practices
+- [Architecture](architecture) - Understanding SCF's internal structure
+- [Security](security) - Security principles and best practices
 
 ## Overview
 

docs/features/fields/index.md

@@ -6,27 +6,27 @@ Each field type has its own documentation and tutorial showing how to implement
 
 ## Available Fields
 
-- [Accordion](accordion/index.md) - Group fields into collapsible sections
-- [Clone](clone/index.md) - Duplicate and reuse existing field configurations
-- [Button Group](button-group/index.md) - Select one option from a group of buttons  
-- [Checkbox](checkbox/index.md) - Select one or more choices
-- [Color Picker](color-picker/index.md) - Choose colors with a visual picker
-- [Date Picker](date-picker/index.md) - Select dates from a calendar
-- [Date/Time Picker](date-time-picker/index.md) - Select dates and times
-- [Email](email/index.md) - Input and validate email addresses
-- [File](file/index.md) - Upload and manage files
-- [Flexible Content](flexible-content/index.md) - Create flexible content layouts
-- [Gallery](gallery/index.md) - Manage collections of images
-- [Google Map](google-map/index.md) - Add location data with Google Maps
-- [Group](group/index.md) - Group fields together
-- [Icon Picker](icon-picker/index.md) - Select from available icons
-- [Image](image/index.md) - Upload and manage images
-- [Link](link/index.md) - Create links with titles and targets
-- [Message](message/index.md) - Display instructional text
-- [Number](number/index.md) - Input numeric values
-- [oEmbed](oembed/index.md) - Embed external content
-- [Page Link](page-link/index.md) - Link to internal content
-- [Password](password/index.md) - Securely input passwords
-- [Post Object](post-object/index.md) - Relate to other posts
-- [Radio](radio/index.md) - Select one choice from options
-- [Range](range/index.md) - Select a numeric value with a slider 
+- [Accordion](accordion) - Group fields into collapsible sections
+- [Clone](clone) - Duplicate and reuse existing field configurations
+- [Button Group](button-group) - Select one option from a group of buttons  
+- [Checkbox](checkbox) - Select one or more choices
+- [Color Picker](color-picker) - Choose colors with a visual picker
+- [Date Picker](date-picker) - Select dates from a calendar
+- [Date/Time Picker](date-time-picker) - Select dates and times
+- [Email](email) - Input and validate email addresses
+- [File](file) - Upload and manage files
+- [Flexible Content](flexible-content) - Create flexible content layouts
+- [Gallery](gallery) - Manage collections of images
+- [Google Map](google-map) - Add location data with Google Maps
+- [Group](group) - Group fields together
+- [Icon Picker](icon-picker) - Select from available icons
+- [Image](image) - Upload and manage images
+- [Link](link) - Create links with titles and targets
+- [Message](message) - Display instructional text
+- [Number](number) - Input numeric values
+- [oEmbed](oembed) - Embed external content
+- [Page Link](page-link) - Link to internal content
+- [Password](password) - Securely input passwords
+- [Post Object](post-object) - Relate to other posts
+- [Radio](radio) - Select one choice from options
+- [Range](range) - Select a numeric value with a slider 

docs/features/index.md

@@ -4,9 +4,9 @@ This section details all features available in Secure Custom Fields.
 
 ## Core Features
 
-- [Post Types](post-types.md) - Create and manage custom post types
-- [Fields](fields/index.md) - Available field types and their usage
-- [API](api.md) - Programmatic access and integration
+- [Post Types](post-types) - Create and manage custom post types
+- [Fields](fields) - Available field types and their usage
+- [API](api) - Programmatic access and integration
 
 ## Feature Categories
 
@@ -27,27 +27,27 @@ This section details all features available in Secure Custom Fields.
 
 ## Available Fields
 
-- [Accordion](fields/accordion/index.md) - Group fields into collapsible sections
-- [Button Group](fields/button-group/index.md) - Select one option from a group of buttons
-- [Checkbox](fields/checkbox/index.md) - Select one or more choices
-- [Clone](fields/clone/index.md) - Duplicate and reuse existing field configurations
-- [Color Picker](fields/color-picker/index.md) - Choose colors with a visual picker
-- [Date Picker](fields/date-picker/index.md) - Select dates from a calendar
-- [Date/Time Picker](fields/date-time-picker/index.md) - Select dates and times
-- [Email](fields/email/index.md) - Input and validate email addresses
-- [File](fields/file/index.md) - Upload and manage files
-- [Flexible Content](fields/flexible-content/index.md) - Create flexible content layouts
-- [Gallery](fields/gallery/index.md) - Manage collections of images
-- [Google Map](fields/google-map/index.md) - Add location data with Google Maps
-- [Group](fields/group/index.md) - Group fields together
-- [Icon Picker](fields/icon-picker/index.md) - Select from available icons
-- [Image](fields/image/index.md) - Upload and manage images
-- [Link](fields/link/index.md) - Create links with titles and targets
-- [Message](fields/message/index.md) - Display instructional text
-- [Number](fields/number/index.md) - Input numeric values
-- [oEmbed](fields/oembed/index.md) - Embed external content
-- [Page Link](fields/page-link/index.md) - Link to internal content
-- [Password](fields/password/index.md) - Securely input passwords
-- [Post Object](fields/post-object/index.md) - Relate to other posts
-- [Radio](fields/radio/index.md) - Select one choice from options
-- [Range](fields/range/index.md) - Select a numeric value with a slider 
+- [Accordion](fields/accordion) - Group fields into collapsible sections
+- [Button Group](fields/button-group) - Select one option from a group of buttons
+- [Checkbox](fields/checkbox) - Select one or more choices
+- [Clone](fields/clone) - Duplicate and reuse existing field configurations
+- [Color Picker](fields/color-picker) - Choose colors with a visual picker
+- [Date Picker](fields/date-picker) - Select dates from a calendar
+- [Date/Time Picker](fields/date-time-picker) - Select dates and times
+- [Email](fields/email) - Input and validate email addresses
+- [File](fields/file) - Upload and manage files
+- [Flexible Content](fields/flexible-content) - Create flexible content layouts
+- [Gallery](fields/gallery) - Manage collections of images
+- [Google Map](fields/google-map) - Add location data with Google Maps
+- [Group](fields/group) - Group fields together
+- [Icon Picker](fields/icon-picker) - Select from available icons
+- [Image](fields/image) - Upload and manage images
+- [Link](fields/link) - Create links with titles and targets
+- [Message](fields/message) - Display instructional text
+- [Number](fields/number) - Input numeric values
+- [oEmbed](fields/oembed) - Embed external content
+- [Page Link](fields/page-link) - Link to internal content
+- [Password](fields/password) - Securely input passwords
+- [Post Object](fields/post-object) - Relate to other posts
+- [Radio](fields/radio) - Select one choice from options
+- [Range](fields/range) - Select a numeric value with a slider 

docs/getting-started/index.md

@@ -4,8 +4,8 @@ This section helps you get up and running with Secure Custom Fields (SCF). Wheth
 
 ## In This Section
 
-- [Installation](installation.md) - How to install and activate SCF
-- [Quick Start](quick-start.md) - Create your first custom field group in minutes
+- [Installation](installation) - How to install and activate SCF
+- [Quick Start](quick-start) - Create your first custom field group in minutes
 
 ## Prerequisites
 

docs/getting-started/quick-start.md

@@ -26,6 +26,6 @@ Let's create a simple author bio field group:
 
 ## Next Steps
 
-- Learn about [field types](../features/fields.md)
-- Explore [advanced features](../features/README.md)
-- Read the [security guidelines](../concepts/security.md) 
+- Learn about [field types](../features/fields)
+- Explore [advanced features](../features/README)
+- Read the [security guidelines](../concepts/security) 

docs/scf.md

@@ -4,4 +4,4 @@ Secure Custom Fields is a WordPress plugin that allows you to create custom fiel
 
 ## Features
 
-- [Fields](features/fields/index.md) - Create and manage custom fields.
+- [Fields](features/fields) - Create and manage custom fields.

docs/tutorials/index.md

@@ -4,9 +4,9 @@ Step-by-step guides for working with Secure Custom Fields.
 
 ## Getting Started
 
-- [Creating Your First Post Type](first-post-type.md) - Basic post type setup
-- [Field Group Basics](field-group-basics.md) - Creating and configuring field groups
-- [Working with Fields](working-with-fields.md) - Using different field types
+- [Creating Your First Post Type](first-post-type) - Basic post type setup
+- [Field Group Basics](field-group-basics) - Creating and configuring field groups
+- [Working with Fields](working-with-fields) - Using different field types
 
 ## Advanced Topics
 

includes/admin/views/acf-field-group/fields.php

@@ -71,7 +71,7 @@
 						sprintf(
 							/* translators: %s url to field types list */
 							__( 'Choose from over 30 field types. <a href="%s" target="_blank">Learn more</a>.', 'secure-custom-fields' ),
-							'https://www.advancedcustomfields.com/resources/'
+							'https://developer.wordpress.org/secure-custom-fields/features/fields/'
 						)
 					);
 					?>