WordPress 3.8 führte im Kern das Plugin MP6 ein, das unter anderem eine Ikone namens Dashicons verwendet, um Schriften im Dashboard anzuzeigen.

Nun ist bekannt, dass register_post_type über ein Argument verfügt 'menu_icon', mit dem ein benutzerdefiniertes Symbol für den CPT-Administratormenüeintrag angegeben werden kann.

In meinen Plugins / Themes verwende ich dieses Argument oft mit meinen benutzerdefinierten Symbolbildern, die normalerweise dunkel sind, weil das 3.8-Admin-Menü einen hellen Hintergrund hatte. Mit dem standardmäßigen dunklen Menühintergrund in WP 3.8 werden meine Symbole fast unsichtbar.

Abgesehen davon denke ich, dass es cool sein wird, die neuen Dashicons für mein CPT zu verwenden.

Nach einigen Recherchen weiß ich, dass ich einfach das CSS von Dashicons verwenden kann, so etwas wie

#menu-posts-mycpt div.wp-menu-image:before { content: "\f226"; }

Wenn Sie jedoch sowohl das 'menu_icon'Argument von register_post_type als auch das vorherige CSS verwenden, werden beide Symbole in WP 3.8 und ein Symbol + ein seltsames Zeichen in WP 3.8- gedruckt. Bei 'menu_icon'älteren Versionen wird ohne Argument das Standardsymbol verwendet.

Ich weiß , ich kann bedingt hinzufügen 'menu_icon'in register_post_typefür WP 3.8- Versionen und bedingt vorherigen CSS für WP hinzufügen 3.8+, aber:

• Das bedeutet, dass für jedes registrierte CPT Code (2 bedingte Anweisungen) hinzugefügt werden muss. Das Aktualisieren von Plugins / Themes ist also eine harte Arbeit
• Es scheint mir eher ein Workaround als eine elegante Lösung

Fragen sind also:

Ist es möglich, Dashicons CSS für WP 3.8+ zu verwenden und benutzerdefinierte Images zu verwenden, die über 'menu_icon'param für frühere Versionen auf "einfachere" Weise eingerichtet wurden, ohne dass für jedes registrierte CPT 2 Bedingungen hinzugefügt werden müssen?

Und wenn ja, ist das auf irgendeine automatische Weise direkt register_post_typeohne zusätzlichen Code möglich?

Nachdem Sie durch das Kaninchenloch und zurück gegangen sind, lautet die Antwort: Ja , Core ermöglicht die einfache Verwendung von Dashicons bei der Registrierung von Beitragstypen und beim Hinzufügen von Menüseiten.

Um das Dashicon zu verwenden, müssen Sie seine CSS-Klasse dashicons-[name]an menu_iconoder icon_urlan relevanten Stellen übergeben.

Verfügbare Klassen können dashicons.cssin der Quell- oder Dashicons-Site nachgeschlagen werden (klicken Sie auf das Symbol und sehen Sie sich den Namen oben an).

Warnen! 3.8 scheint mit dashicons-piechartals Beispiel für die Klasse in Inline-Dokumenten veröffentlicht worden zu sein, was falsch ist und nicht funktioniert. Tatsächliche Klasse für dieses Symbol in Release ist dashicons-chart-pie.

Ganz einfach: register_post_type()Lies einfach den relevanten Teil des phpDocBlocks und verwende dann das richtige Argument für menu_icon: D

• Verwenden Sie die Dashicons- Klasse. Zum Beispieldashicon-groups
• Übergeben Sie eine base64-codierte SVG-Datei mit einem Daten-URI, der entsprechend dem Farbschema farbig dargestellt wird. Dies sollte mit beginnen data:image/svg+xml;base64,.
• Pass 'none'verlassen div.wp-menu-imageleer, so kann ein Symbol über CSS hinzugefügt werden.

Ich antworte mir selbst, weil ich mir heute die beiden Fragen gestellt habe und einige Zeit damit verbracht habe, eine Antwort zu finden. Sobald ich eine Lösung gefunden habe, möchte ich sie teilen, aber jede andere Lösung wird sehr geschätzt und ich bin bereit, jede Lösung zu akzeptieren, die ich besser als meine gefunden habe. Änderungen und Verbesserungen an meiner Lösung sind ebenfalls erwünscht.

Bearbeiten

Nach der Antwort von Rarst habe ich den Code bearbeitet. Die Funktion verwendet jetzt Standard-Dashicons-Klassen, ermöglicht jedoch auch die Angabe einer alten Bild-URL im menu_iconArgument und einer brandneuen Dashicons-Klasse im menu_dashiconArgument.

Arbeitsablauf

Zuerst dachte ich mir, dass register_post_typeeine Aktion registered_post_typeausgelöst wird, die die übergebenen Argumente an Hook-Funktionen übergibt register_post_type, ohne sie zu filtern. Auf diese Weise können benutzerdefinierte Argumente für diese Funktionen erstellt werden.

Also habe ich beschlossen, das Argument 'menu_dashicon'zu übergeben, um ein benutzerdefiniertes Dashicon zu übergeben.

Danach überlegte ich, eine Klasse zu erstellen, die auf dieses Argument hört und das Symbol in einer Klassenvariablen speichert. Die gleiche Klasse kann dafür verantwortlich sein

1. Überprüfen Sie die aktuelle Version von WP, und wenn es weniger als 3.8 ist, tun Sie nichts
2. Wenn die Version 3.8+ ist, schleifen Sie das $menuArray auf den richtigen Hook und:
3. Entfernen Sie, falls vorhanden, benutzerdefinierte Bilder, die über 'menu_icon'und hinzugefügt wurden
4. 'menu_dashicon'Fügen Sie den Inline-Stil entsprechend dem hinzu, was über den Parameter hinzugefügt wird

Ich erstelle den Code in einer einzigen Datei, auf diese Weise kann er einfach in ein beliebiges Theme / Plugin eingefügt oder sogar als MU-Plugin verwendet werden. Danach kann man einfach das brandneue 'menu_dashicon'Argument in jedem installierten Theme und / oder Plugin verwenden.

Ich habe auch einen minimalen Plugin-Header hinzugefügt, mit dem es als eigenständiges Plugin verwendet werden kann, aber wahrscheinlich ist dies die weniger nützliche Methode.

Wie benutzt man

Innerhalb übergeben Sie register_post_typeeinfach das 'menu_dashicon'Argument mit dem Wert der Dashicon-Klasse ( ohne Präfix 'dashicons-'):

$args = array(
  ...
  'menu_dashicon' => 'chart-pie', // dashicons will be used in WP 3.8+
  'menu_icon' => $url_of_the_icon // icon images will be used in WP 3.7.1 & previous
);

register_post_type('my_cpt', $args);

Das ist alles. Ruft den Klassennamen des Dashicons-Symbols von seiner Site ab .

Also hier der Code:

<?php
/**
* Plugin Name: GM CPT Icon
*/
namespace GM;

class CptIcon {

  public static $cpt;

  public $css;

  static function registerIcon( $cpt, $icon ) {
    self::$cpt[$cpt] = $icon;
  }

  function init() {
    if ( $this->mp6() ) {
      \add_action('admin_menu', array($this, 'parseMenu') );
    }
  }

  function mp6() {
    return \version_compare( $GLOBALS['wp_version'],  '3.8', '>=' );
  }      

  function parseMenu() {
    if ( $this->mp6() && ! empty( self::$cpt ) )  {
      foreach ( $GLOBALS['menu'] as $i => $item ) {
        if  $item[1] === 'edit_posts' && (strpos($item[2], 'edit.php?post_type=') === 0)) {
          $this->menuItemClass($i, str_replace('edit.php?post_type=', '', $item[2]));
        }
      }
    }
  }

  function menuItemClass( $i, $type ) {
    if ( \in_array($type, \array_keys(self::$cpt), TRUE ) ) {
      $GLOBALS['menu'][$i][4] = str_replace('menu-icon-post', '', $GLOBALS['menu'][$i][4]);
      $GLOBALS['menu'][$i][6] = 'dashicons-' . self::$cpt[$type];
    }
  }

}

\add_action('plugins_loaded', function() {
  if ( \is_admin() && !( \defined('DOING_AJAX') && \DOING_AJAX  ) ) {
    $cpticon = new CptIcon;
    $cpticon->init();
  }
});

\add_action('registered_post_type', function( $post_type, $args ) {
  if ( isset($args->menu_dashicon) && ! empty($args->menu_dashicon) ) {
    CptIcon::registerIcon($post_type, $args->menu_dashicon);
  }
}, 10, 2);

Es ist auch als Gist erhältlich

Zwei CPTs: "Ideen" und "Galerie" mit Dashicons. Beachten Sie den automatischen Farbwechsel mit verschiedenen Admin-Farbschemata.

Ich habe einfach diese Zeile zum Code hinzugefügt, der den benutzerdefinierten Beitragstyp registriert:

'menu_icon'    => 'dashicons-admin-users',

Hier ist der vollständige Code

Es muss kein CSS hinzugefügt werden.