Conditionally display featured image on singular posts and pages

FAQ

Das Plugin funktioniert nicht mit meinem Theme. Was kann ich tun?

In der Regel gibt es zwei Möglichkeiten, warum das Plugin nicht mit deinem Theme kompatibel ist:

1) Das Theme lädt das Beitragsbild vor dem Loop (z.B. im Header).
2) Das Theme macht einen benutzerdefinierten Aufruf, um das Beitragsbild zu laden.

Im Fall 1 kannst du das Plugin frühzeitig initialisieren und die in_the_loop Prüfung deaktivieren. Dazu kannst du den folgenden Schnipsel in deine functions.php einfügen:

function cybocfi_set_startup_hook() {
    return 'get_header';
}

add_filter( 'cybocfi_startup_hook', 'cybocfi_set_startup_hook' );
add_filter( 'cybocfi_only_hide_in_the_loop', '__return_false' );

Bitte beachte, dass dies einige Nebeneffekte haben kann: Z.B. kann es das Beitragsbild auch vor Plugins verbergen, die es normalerweise sehen würden, wie z.B. SEO-Plugins oder das Plugin „Latest Posts“.

In Fall 2 entweder

• Bitte den Entwickler des Themes, eine der folgenden WordPress-Funktionen zu verwenden (wp_get_attachment_image(), get_the_post_thumbnail(), the_post_thumbnail()), um das Beitragsbild in der Einzelansicht zu laden.
• oder erstelle ein child theme, das den Aufruf, der das Beitragsbild lädt, durch eine der oben aufgeführten Methoden ersetzt.

Ist dieses Plugin GDPR-konform?

Dieses Plugin verarbeitet oder speichert keine personenbezogenen Daten. Daher ist es ohne Weiteres vollständig DSGVO-konform.

Kann ich das Beitragsbild standardmässig verbergen?

Ja. Füge einfach die folgende Zeile in dein functions.php ein:

add_filter('cybocfi_hide_by_default', '__return_true');

Alle neuen Beiträge und Seiten verbergen das Beitragsbild nun standartmässig (Kästchen ist standartmässig angekreuzt). Bestehende Beiträge und Seiten werden nicht geändert.

Du kannst auch unterschiedliche Standartwerte in Abhängigkeit des Inhaltstyps festlegen:

function cybocfi_set_default_hiding_state( $default, $post_type ) {
    if ( 'post' === $post_type ) {
        $default = true; // set the default state for posts
    } else if ( 'page' === $post_type ) {
        $default = false; // set the default state for pages
    }

    return $default;
}
add_filter( 'cybocfi_hide_by_default', 'cybocfi_set_default_hiding_state', 10, 2 );

Kann ich dieses Plugin auf Beiträge beschränken (und andere Inhaltstypen ausschließen)?

Ja. Standardmäßig ist das Plugin für jeden Inhaltstyp verfügbar, der ein Beitragsbild enthält. Es gibt aber einen Filter, mit dem du kontrollieren kannst, für welche Inhaltstypen das Plugin verfügbar sein soll. Das folgende Beispiel deaktiviert es für alles ausser Beiträge:

function cybocfi_limit_to_posts( $enabled, $post_type ) {
    if ( 'post' === $post_type ) {
        return $enabled;
    }

    return false;
}
add_filter( 'cybocfi_enabled_for_post_type', 'cybocfi_limit_to_posts', 10, 2 );

Der Filter liefert dir den aktuellen Inhaltstyp und du kannst entscheiden, ob du das Plugin für diesen Inhaltstyp verwenden möchtest, indem du true zum Aktivieren und false zum Deaktivieren zurückgibst. Füge das folgende Snippet zu deiner functions.php hinzu, um das Plugin für Beiträge und Seiten zu aktivieren, es aber für alle anderen Inhaltstypen zu deaktivieren:

function cybocfi_limit_to_posts_and_pages( $enabled, $post_type ) {
    $allowed_post_types = array( 'post', 'page' ); // add any post type you want to use the plugin with
    return in_array( $post_type, $allowed_post_types );
}
add_filter( 'cybocfi_enabled_for_post_type', 'cybocfi_limit_to_posts_and_pages', 10, 2 );

Gibt es das Plugin in meiner Sprache?

Absolut. Du bist eingeladen, eine Übersetzung in deine Sprache
beizusteuern. Bitte beachte, dass die Übersetzung von der Community geprüft werden muss, es wird deshalb eine Weile dauern bis die Übersetzung akzeptiert wird.

Wie kann ich den Text der Checkbox ändern?

Dafür gibt es einen Filter-Hook. Füge das folgende Snippet zu deiner functions.php hinzu:

function cybocfi_set_featured_image_label( $label ) {
    return 'Hide featured image in post'; // change this string
}
add_filter( 'cibocfi_checkbox_label', 'cybocfi_set_featured_image_label' );

In WordPress 5.7.0 kann ich keine Beiträge speichern

Ein Fehler im WordPress-Core #52787 kann dieses Plugin unbrauchbar machen, wenn ein zweites Plugin Post-Meta-Werte auf eine bestimmte Weise verwendet. Wer von diesem Problem betroffen ist, sieht folgende Fehlermeldung „Updating failed. Could not delete meta value from database.“. Da das Problem mit dem WordPress-Core zusammenhängt, besteht die Abhilfe darin, ein Downgrade auf WordPress 5.6.2 oder ein Upgrade auf WordPress 5.7.1 durchzuführen. Nach unserem derzeitigen Kenntnisstand sind nur sehr wenige Benutzer von diesem Fehler betroffen. Das Plugin „Conditionally display featured image on singular posts and pages“ selbst funktioniert in WordPress 5.7.0 wie erwartet und das Problem tritt nur auf, wenn ein zweites Plugin den Fehler im WordPress-Core auslöst.

I’m getting a deprecation notice, what must I do?

The cybocfi_post_type filter was deprecated in favor of cybocfi_enabled_for_post_type, as the filter arguments were used in an unusual way. Transitioning from the former to the latter is easy. Here an example:

// Using the deprecated filter - REMOVE THIS CALL
function cybocfi_limit_to_posts( $post_type, $enabled ) {
    if ( 'post' === $post_type ) {
        return $enabled;
    }

    return false;
}
add_filter( 'cybocfi_post_type', 'cybocfi_limit_to_posts', 10, 2 );

// Using the new filter - THIS IS HOW IT SHOULD BE DONE NOW
function cybocfi_limit_to_posts( $enabled, $post_type ) {
    if ( 'post' === $post_type ) {
        return $enabled;
    }

    return false;
}
add_filter( 'cybocfi_enabled_for_post_type', 'cybocfi_limit_to_posts', 10, 2 );

All you’ve got to do is:

1) Change the filter hook from cybocfi_post_type to cybocfi_enabled_for_post_type.
2) Swap the filter functions arguments. $enabled is now the first argument $post_type the second.

In case you’ve only used one argument ($post_type), you must not only adapt the function signature, but also add the priority and number of arguments to your add_filter() function call. Just as it is shown in the example above.