11 Kommentare zu “5.3. Die Settings API”

1. wenn man Optionsfelder setzt, sollten dann diese auch beim deaktivieren des Plugins entfernt werden?
   Reicht dann die Funktion unregister_setting()? Oder gibt es auch für die Felder eine delete function? In der Referece bin ich nicht fündig geworden.

   lg
   Andreas

   PS: hast du meine eMail bekommen?

2. Ja richtig. Optionen sollten immer beim Deinstallieren entfernt werden. Sonst bleiben sie in der Datenbank als Leichen gespeichert.
   unregister_setting() hilft an der Stelle nicht. Denn es würde nur das Einstellungsfeld von der Settings-Page entfernen falls dort bereits hinzugefügt wurde.

   Es kommt darauf an, wo man seine Einstellungen gespeichert hat. In der Regel nutzt man die Options API. Ein delete_option() wäre dann richtig um die Einstellung aus der Datenbank zu entfernen.

3. Wenn ich ein inputfeld hinzufüge, das ich nur zur überprüfung benötige und nicht gespeichert werden soll, wie filtere ich das zb. $_POST[‘beispiel’] nach dem klicken auf den submit button heraus?

4. Ich glaube, die Antwort darauf hast du dir selbst schon gegeben. Oder was meinst du genau?

5. Mein Problem daran ist, dass ich auf das einzelne Input Feld keinen Einfluss habe. Ich habe in meinem Form eine checkbox, das gesetzt wird, wenn zb die Tabellen in Datenbank neu erstellt werden sollen. Mit dem $_POST kann ich zwar das Feld abfragen, aber nicht verhindern, das dieses Feld nicht mit der setting_api in der wp_option mitgespeichert wird. Die checkbox erstelle ich genau so wie in diesem Beispiel beschrieben. Daher meine Frage wie kann ich verhindern, das die Einstellung dieser Checkbox nicht in die wp_options gespeichert wird

6. Wenn du nicht möchtest, dass ein Feld überhaupt gespeichert wird, kannst du den Filter whitelist_options nutzen und das Feld entfernen bevor es gespeichert wird. Im Beispiel von oben würde das z.B. so funktionieren:

   
   add_filter( 'whitelist_options', function ( $whitelist_options ) {
   
   	if ( isset( $whitelist_options['mm_settings_group'] ) ) {
   		$k = array_search( 'mm_settings_section_1_field_1', $whitelist_options['mm_settings_group'] );
   
   		if ( false !== $k ) {
   			unset( $whitelist_options['mm_settings_group'][ $k ] );
   		}
   	}
   
   	return $whitelist_options;
   }, 20 );
   

7. Ich habe ein Problem mit den register_setting. folgenden code habe ich geschrieben:

   
   public function options_update() {
   		register_setting( $this->plugin_name, $this->plugin_name, [$this, 'fsct_validate'] );
   		if( isset( $_REQUEST['settings-updated'] ) ){
   			print_r($this->_renew_table);
   			$fsct_db = new fsct_database( $this->plugin_name );
   			$fsct_db->fsct_install();
   		}
   	}
   
   public function fsct_validate( $input ) {
   		// All checkboxes inputs	
   		$valid = array();
   		print_r( $input );
   		$valid['db_name'] = ( isset( $input['db_name'] ) && !empty( $input['db_name'] ) ) ? sanitize_text_field( $input['db_name'] ) : DB_NAME;
   		$valid['db_user'] = ( isset( $input['db_user'] ) && !empty( $input['db_user'] ) ) ? sanitize_text_field( $input['db_user'] ) : DB_USER;
   		$valid['db_pwd'] = ( isset( $input['db_pwd'] ) && !empty( $input['db_pwd'] ) ) ? sanitize_text_field( $input['db_pwd'] ) : DB_PASSWORD;
   		$valid['db_host'] = ( isset( $input['db_host'] ) && !empty($input['db_host'] ) ) ? sanitize_text_field( $input['db_host'] ) : DB_HOST;
   		$valid['db_prefix'] = ( isset( $input['db_prefix'] ) && !empty($input['db_prefix'] ) ) ? sanitize_text_field( $input['db_prefix'] ) : 'fs';
   		$valid['tbl_installed'] = ( isset( $input['tbl_installed'] ) && !empty($input['tbl_installed'] ) ) ? sanitize_text_field( $input['tbl_installed'] ) : '0';
   		$valid['renew_tables'] = ( isset( $input['renew_tables'] ) && !empty( $input['renew_tables'] ) ) ? '1' : '0';
   
   		$this->_renew_table = $valid['renew_tables'];
   		return $valid;		
   	}
   

   jedoch schein es so als würde mir der Validate nicht aufgerufen. Denn die var $this->_renew_table wird in dieser Funktion nie gesetzt auch kann ich $input nicht abfragen. Irgend etwas ist in meiner Überlegung falsch und im Internet komme ich auch nicht weiter. Hast du einen Tipp wo ich meinen Fehler habe?

8. Servus Andreas,
   seit WordPress 4.7.0 benötigt register_setting() als letzten Parameter ein Array mit Argumenten. Dort kannst du dann den Callback angeben. Richtig wäre also in deinem Fall:

   
   register_setting(
   	$this->plugin_name,
   	$this->plugin_name,
   	[
   		'sanitize_callback' => [ $this, 'fsct_validate' ],
   	]
   );
   

   Bitte versuch es doch einmal so.

9. Darüber hinaus: Bist du dir sicher, dass zweimal $this->plugin_name richtig ist?

10. Ja so wie du beschrieben hast funktioniert jetzt der Aufruf von fsct_validate. Ich setze in dieser Funktion die Variable $this->_renew_table = $valid[‘renew_tables’]; diese Private Var kann ich aber in der klassen funktion nach dem register_setting aufruf nicht abfragen. Innerhalb der fsct_validate wird der Wert nicht der Klassen Var zugewiesen.

    
    $valid['renew_tables'] = ( isset( $input['renew_tables'] ) && !empty( $input['renew_tables'] ) ) ? '1' : '0';
    $this->_renew_table = $valid['renew_tables'];
    

    Auch dieser Filter for dem register_setting funktioniert nicht.

    
    add_filter( 'whitelist_options', function ( $whitelist_options ) {
      if( isset( $whitelist_options[ $this->plugin_name ] ) ){
    	print_r( $whitelist_options );
      }
    });
    

    ich bekomme immer einen Array ausgegeben (mit print_r mache ich das damit ich sehe ob daten drinnen stehen) mit dem error ERROR: options page not found.

    Bei deiner zweiten Anmerkung, bin ich mir nicht sicher. Ich habe im Internet gestöbert und es ein paarmal so vorgefunden, wenn ich alle options in einem speichern möchte und nicht jeden Wert einzeln.

11. A) Wie stellst du fest, dass der Wert an $this->_renew_table nicht zugewiesen wird?
    B) Beachte bitte, dass ein Filter immer einen Rückgabewert haben muss. Bei dir fehlt return $whitelist_options. Wahrscheinlich führt das zu einem genannten Fehler.