Dodaj niestandardowy skrypt analityczny do WordPressa łatwo
Objaśnienie
Aby dodać niestandardowy skrypt analityczny do swojej witryny WordPress, będziesz korzystać z kilku funkcji, które współpracują ze sobą, aby zapewnić, że skrypt jest ładowany poprawnie i bezpiecznie.
Oto co się dzieje:
- Pierwsza funkcja, wp_dudecom_add_custom_analytics_script, odpowiada za ładowanie zewnętrznego skryptu analitycznego. Wykorzystuje wbudowaną metodę WordPressa do dodawania skryptów, co zapewnia, że jest on dodawany tylko do front-endu (części witryny widocznej dla odwiedzających), a nie do obszaru administracyjnego.
- Skrypt jest ładowany w stopce Twojej witryny, co jest dobrą praktyką w celu poprawy czasów ładowania strony.
Następnie jest kolejna funkcja o nazwie wp_dudecom_add_custom_analytics_inline_script. Ta funkcja dodaje mały fragment kodu bezpośrednio do Twojej witryny, aby zainicjować narzędzie analityczne. Sprawdza, czy narzędzie analityczne jest gotowe do działania, a następnie uruchamia je, używając Twojego unikalnego identyfikatora śledzenia.
Obie funkcje są podpięte do WordPressa za pomocą add_action, co informuje WordPress, kiedy uruchomić te funkcje. W tym przypadku są one uruchamiane, gdy skrypty są dodawane do Twojej witryny.
Pamiętaj, aby zastąpić 'YOUR_TRACKING_ID'
rzeczywistym identyfikatorem śledzenia dostarczonym przez Twojego dostawcę analityki, aby zapewnić poprawne śledzenie.
Kod
<?php
/**
* Add a custom analytics script to the WordPress site.
*
* This function safely enqueues a custom analytics script from an external provider.
* It uses WordPress hooks to ensure the script is added to the footer of the site.
*
* @return void
*/
function wp_dudecom_add_custom_analytics_script() {
// Ensure the script is only added to the front-end
if ( ! is_admin() ) {
// Use wp_enqueue_script to add the external analytics script
wp_enqueue_script(
'wp-dudecom-custom-analytics', // Handle for the script
'https://example.com/analytics.js', // URL of the external analytics script
array(), // Dependencies
null, // Version number (null to prevent caching issues)
true // Load in footer
);
}
}
add_action( 'wp_enqueue_scripts', 'wp_dudecom_add_custom_analytics_script' );
/**
* Add inline script for custom analytics initialization.
*
* This function adds an inline script to initialize the custom analytics.
* It ensures that the script is executed after the external script is loaded.
*
* @return void
*/
function wp_dudecom_add_custom_analytics_inline_script() {
// Inline script to initialize the analytics
$inline_script = "
(function() {
if (typeof customAnalytics !== 'undefined') {
customAnalytics.init({
trackingId: 'YOUR_TRACKING_ID'
});
}
})();
";
// Add the inline script after the custom analytics script
wp_add_inline_script( 'wp-dudecom-custom-analytics', $inline_script );
}
add_action( 'wp_enqueue_scripts', 'wp_dudecom_add_custom_analytics_inline_script' );
?>
Instrukcja
Lokalizacja pliku: Dodaj poniższy kod do pliku functions.php
swojego motywu lub do pliku własnej wtyczki.
Wymagania wstępne:
- Upewnij się, że masz dostęp do systemu plików swojej witryny WordPress.
- Miej pod ręką identyfikator śledzenia od swojego dostawcy analityki.
Kroki wdrożenia:
- Otwórz plik
functions.php
swojej witryny WordPress lub stwórz nowy plik własnej wtyczki, jeśli wolisz trzymać dostosowania oddzielnie od swojego motywu. - Skopiuj i wklej podany kod do pliku.
- Znajdź linię w kodzie, która brzmi
'YOUR_TRACKING_ID'
. - Zamień
'YOUR_TRACKING_ID'
na rzeczywisty identyfikator śledzenia dostarczony przez twojego dostawcę analityki. - Zapisz zmiany w pliku.
- Odwiedź front-end swojej witryny WordPress, aby upewnić się, że skrypt ładuje się poprawnie. Możesz użyć narzędzi dewelopera w przeglądarce, aby zweryfikować, że skrypt jest obecny w stopce.
Jeśli napotkasz jakiekolwiek problemy lub potrzebujesz dalszej pomocy przy tym wdrożeniu lub bardziej zaawansowanej funkcjonalności, rozważ skontaktowanie się z wp-dude.com w celu uzyskania fachowej pomocy.