network_site_url( string $path = '', string $scheme = null )

Récupère l'url d'un site pour le réseau actuel.

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.

Déclaration et structure de la fonction network_site_url()

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 );
}
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.

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).

network_site_url

Filtre l'url du site d'un réseau.

Où est utilisée 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