'' );
}
public function sanitize( array $data ): array {
$raw = isset( $data['custom_rules'] ) ? (string) $data['custom_rules'] : '';
// Allow line breaks; sanitize_textarea_field strips tags and normalizes
// line endings while preserving the multi-line structure of robots.txt.
$clean = sanitize_textarea_field( wp_unslash( $raw ) );
return array( 'custom_rules' => $clean );
}
public function register(): void {
add_filter( 'robots_txt', array( $this, 'append_custom_rules' ), 20, 2 );
}
/**
* Append the saved custom rules to whatever robots.txt content has been
* built up by core + other plugins. Late priority (20) so we land below
* Yoast's Sitemap line and any other contributors.
*
* @param string $output Current robots.txt body.
* @param string $public Value of the `blog_public` option (string '0' or '1').
*/
public function append_custom_rules( $output, $public ) {
unset( $public );
$rules = (string) bw_dev()->settings()->get( $this->slug(), 'custom_rules', '' );
$rules = trim( $rules );
if ( '' === $rules ) {
return $output;
}
$output = rtrim( (string) $output, "\n" );
return $output . "\n\n# Added by BW Dev → Robots.txt Manager\n" . $rules . "\n";
}
/* ---------------------------------------------------------------------
* Settings tab
* ------------------------------------------------------------------- */
/**
* Build the live robots.txt preview by running the same filter chain WP
* uses when serving /robots.txt — so the preview reflects core defaults,
* Yoast/etc additions, and our own appended rules.
*/
private function preview(): string {
$public = (string) get_option( 'blog_public' );
if ( '0' === $public ) {
$base = "User-agent: *\nDisallow: /\n";
} else {
$base = "User-agent: *\nDisallow: /wp-admin/\nAllow: /wp-admin/admin-ajax.php\n";
}
return (string) apply_filters( 'robots_txt', $base, $public );
}
private function physical_file_path(): string {
return rtrim( ABSPATH, '/\\' ) . '/robots.txt';
}
public function render_tab(): void {
$current = (string) bw_dev()->settings()->get( $this->slug(), 'custom_rules', '' );
$field_name = BW_Dev_Settings::OPTION . '[' . $this->slug() . '][custom_rules]';
$preview = $this->preview();
$physical = $this->physical_file_path();
$has_physical = file_exists( $physical );
$robots_url = home_url( '/robots.txt' );
?>
' . esc_html( $physical ) . ''
);
?>
' . esc_html( $robots_url ) . ''
);
?>