Update settings description (#1637)

Improve wp-admin settings page.

Updates description of Secret Key field.

Updates docs links to point to current page URLs.

add changeset

.changeset/wet-buttons-love.md

@@ -0,0 +1,5 @@
+---
+'@faustwp/wordpress-plugin': patch
+---
+
+Updated the settings page to improve descriptions and documentation links.

plugins/faustwp/includes/settings/callbacks.php

@@ -340,8 +340,8 @@ function confirm_regenerate_key( event ) {
 		<?php
 		printf(
 			/* translators: %s: Documentation URL. */
-			wp_kses_post( __( 'This key is used to enable <a href="%s" target="_blank" rel="noopener noreferrer">headless post previews</a>.', 'faustwp' ) ),
-			'https://faustjs.org/docs/next/guides/post-page-previews'
+			wp_kses_post( __( 'This key is used to enable <a href="%s" target="_blank" rel="noopener noreferrer">headless post previews</a> and make authenticated GraphQL requests for schema generation.', 'faustwp' ) ),
+			'https://faustjs.org/guide/how-to-setup-post-and-page-previews'
 		);
 		?>
 	</p>

plugins/faustwp/includes/settings/views/headless-settings.php

@@ -79,11 +79,11 @@
 					<h3>Faust.js Documentation</h3>
 					<section>
 						<ul>
-							<li><a href="https://faustjs.org/docs/tutorial/dev-env-setup" target="_blank" rel="noopener noreferrer">In-depth Tutorial</a></li>
-							<li><a href="https://faustjs.org/docs/next/getting-started" target="_blank" rel="noopener noreferrer">Quick Start</a></li>
-							<li><a href="https://faustjs.org/docs/next/guides/fetching-data" target="_blank" rel="noopener noreferrer">Fetching Data</a></li>
-							<li><a href="https://faustjs.org/docs/next/guides/post-page-previews" target="_blank" rel="noopener noreferrer">Previews</a></li>
-							<li><a href="https://faustjs.org/docs/next/guides/auth" target="_blank" rel="noopener noreferrer">Authentication</a></li>
+							<li><a href="https://faustjs.org/guide/how-to-use-the-faust-example-project" target="_blank" rel="noopener noreferrer">In-depth Tutorial</a></li>
+							<li><a href="https://faustjs.org/tutorial/get-started-with-faust" target="_blank" rel="noopener noreferrer">Quick Start</a></li>
+							<li><a href="https://faustjs.org/guide/how-to-use-apollo-in-faust" target="_blank" rel="noopener noreferrer">Fetching Data</a></li>
+							<li><a href="https://faustjs.org/guide/how-to-setup-post-and-page-previews" target="_blank" rel="noopener noreferrer">Previews</a></li>
+							<li><a href="https://faustjs.org/guide/how-to-handle-authentication" target="_blank" rel="noopener noreferrer">Authentication</a></li>
 						</ul>
 						<p><a class="button-primary" href="https://github.com/wpengine/faustjs/" target="_blank" rel="noopener noreferrer">Faust on GitHub</a></p>
 					</section>