network_site_url() | Fonctions Wordpress

Paramètres

$path

(string) (Optionnel) Chemin relatif à l'url du site.

Valeur par défaut : ''

$scheme

(string) (Optionnel) Schema à donner pour le context de l'url du site.

Valeur par défaut : null

Retourne

(string) L'url du site avec un chemin optionnel.

Structure de la fonction `network_site_url()`

Définie dans le fichier wp-includes/link-template.php à la ligne 3466 :

function network_site_url( $path = '', $scheme = null ) {
    if ( ! is_multisite() ) {
        return site_url( $path, $scheme );
    }

    $current_network = get_network();

    if ( 'relative' === $scheme ) {
        $url = $current_network->path;
    } else {
        $url = set_url_scheme( 'http://' . $current_network->domain . $current_network->path, $scheme );
    }

    if ( $path && is_string( $path ) ) {
        $url .= ltrim( $path, '/' );
    }

    /**
     * Filters the network site URL.
     *
     * @since 3.0.0
     *
     * @param string      $url    The complete network site URL including scheme and path.
     * @param string      $path   Path relative to the network site URL. Blank string if
     *                            no path is specified.
     * @param string|null $scheme Scheme to give the URL context. Accepts 'http', 'https',
     *                            'relative' or null.
     */
    return apply_filters( 'network_site_url', $url, $path, $scheme );
}

Fonctions et Hook utilisés par `network_site_url()`

get_network(): Récupère les données d'un réseau en donnant l'id du réseau ou son objet.
is_multisite(): Vérifie si le multisite est autorisé.
set_url_scheme(): Règle le schema pour une url.
network_site_url: Filtre l'url du site d'un réseau.
site_url(): Récupère l'url pour le site actuel où les fihciers d'application Wordpress sont accessibles (ex : wp-blog-header.php ou the wp-admin/ folder).

Où trouver la fonction `network_site_url()` dans le CMS Wordpress

Exemples

Exemple basic :

$url = network_site_url();
echo $url;
// Affiche l'url du site actuel

Avec une spécification https :

$url = network_site_url('/contact-us/', 'https');
echo $url;
// Affiche https://www.example.com/contact-us/

Sources

Codex Wordpress : network_site_url()

Autres fonctions dans le même fichier : wp-includes/link-template.php

Retour