Converter for Media – Optymalizacja obrazków | Konwertuj do WebP i AVIF

Najczęściej zadawane pytania

Jak mogę zgłaszać błędy bezpieczeństwa?

Możesz zgłaszać błędy bezpieczeństwa za pośrednictwem programu ujawniania luk w zabezpieczeniach Patchstack. Zespół Patchstack pomaga weryfikować, sortować i obsługiwać wszelkie luki w zabezpieczeniach.

Zgłoś lukę w zabezpieczeniach

Jak uzyskać wsparcie techniczne? (zanim poprosisz o pomoc)

Zanim dodasz nowy wątek, przeczytaj najpierw wszystkie inne pytania w tym FAQ i innych wątkach na forum wsparcia. Być może ktoś miał podobny problem i został on rozwiązany.

Podczas dodawania wątku wykonaj poniższe kroki i odpowiedz na każdy z nich:

1. Czy masz jakieś błędy na stronie ustawień wtyczki? Przeczytaj ten wątek, jeśli masz jakieś błędy.

2. Adres URL Twojej witryny.

3. Zrzut ekranu karty Centrum pomocy na ekranie ustawień wtyczki – zrób zrzut ekranu CAŁEJ strony.

4. Wykonaj test, który jest opisany w FAQ w pytaniu „Jak sprawdzić, czy wtyczka działa?”. Prześlij zrzut ekranu Devtools z wynikami testu.

Pamiętaj, aby uwzględnić odpowiedzi na wszystkie pytania, dodając wątek. Jest to o wiele łatwiejsze i przyspiesza rozwiązanie Twojego problemu.

Konfiguracja dla Nginx

Jeśli używasz serwera Nginx, który nie obsługuje reguł .htaccess, aby wtyczka działała prawidłowo, wymagana jest dodatkowa konfiguracja serwera Nginx.

Aby uzyskać więcej informacji, przeczytaj ten poradnik.

Konfiguracja dla serwera Proxy Nginx

Jeśli używasz serwera Nginx, który obsługuje reguły .htaccess, ale nadal widzisz błąd konfiguracji serwera na stronie ustawień wtyczki, konieczna jest dodatkowa konfiguracja serwera Nginx, aby wtyczka działała prawidłowo.

Aby uzyskać więcej informacji, przeczytaj ten samouczek.

Błąd na ekranie ustawień wtyczki?

Jeśli masz błąd na ekranie ustawień wtyczki, najpierw przeczytaj je uważnie. Są one wyświetlane, gdy występuje problem z konfiguracją serwera lub witryny.

Wiadomości mają na celu zmniejszenie liczby powtarzanych próśb o pomoc techniczną. Oszczędza to Twój i nasz czas. Przeczytaj ten wątek, aby uzyskać więcej informacji.

Wystąpił błąd podczas konwersji?

Podczas konwersji możesz otrzymać kilka typów błędów. Przede wszystkim uważnie przeczytaj ich treść. W większości przypadków możesz rozwiązać ten problem samodzielnie. Spróbuj to zrobić lub skontaktuj się z administratorem serwera.

Jeśli pojawi się błąd: Plik "%s" nie istnieje. Sprawdź ścieżkę pliku. oznacza, że ​​funkcja file_exists() w PHP zwróciła false, używając ścieżki pliku podanej w komunikacie o błędzie. Sprawdź tę ścieżkę i upewnij się, że jest poprawna.

Jeśli pojawi się błąd: Plik "%s" jest nieczytelny. Proszę sprawdzić uprawnienia pliku. oznacza, że ​​funkcja is_readable() w PHP zwróciła false, używając ścieżki pliku podanej w komunikacie o błędzie. Sprawdź uprawnienia pliku i katalog, w którym się znajduje.

Jeśli pojawi się błąd: "%s" nie jest prawidłowym plikiem obrazka. oznacza, że ​​plik jest w jakiś sposób uszkodzony. Pobierz plik na dysk, zapisz go ponownie za pomocą dowolnego programu graficznego i dodaj go ponownie do strony. Jeśli błąd dotyczy pojedynczych obrazków, możesz go zignorować — zostaną wczytane tylko oryginalne obrazki, a nie WebP.

Jeśli pojawi się błąd: Obrazek „%s” przekonwertowany do formatu .webp jest większy niż oryginał, a przekonwertowany plik .webp został usunięty. oznacza, że ​​oryginalny obrazek ważył mniej niż WebP. Dzieje się tak, gdy obrazki zostały wcześniej skompresowane. Wyłącz opcję „Automatyczne usuwanie plików w formatach wyjściowych większych niż oryginał” w ustawieniach wtyczki, aby wymusić zawsze używanie WebP.

Jakie są wymagania wtyczki?

Praktycznie każdy hosting spełnia te wymagania. Musisz używać PHP co najmniej 7.0 i mieć zainstalowane rozszerzenie GD lub Imagick. Rozszerzenie musi obsługiwać format WebP. Jeśli pojawi się błąd mówiący, że biblioteka GD lub Imagick nie jest zainstalowana, a masz ją zainstalowaną, prawdopodobnie są one nieprawidłowo skonfigurowane i nie mają obsługi WebP.

Są to wymagane natywne rozszerzenia PHP, używane między innymi przez WordPress do generowania miniaturek. Twój serwer musi mieć również włączone moduły mod_mime, mod_rewrite i mod_expires.

Przykład prawidłowej konfiguracji serwera można znaleźć tutaj. Odnośnik do bieżącej konfiguracji można znaleźć w karcie Centrum pomocy na ekranie ustawień wtyczki.

Zwróć uwagę na elementy oznaczone na czerwono. Jeśli wartości oznaczone na czerwono nie pojawiają się w Twoim przypadku, oznacza to, że Twój serwer nie spełnia wymagań technicznych. Zwróć uwagę na wartość Wsparcie WebP dla biblioteki GD i WEBP na liście obsługiwanych rozszerzeń dla biblioteki Imagick.

W sytuacji, gdy Twój serwer nie spełnia wymagań technicznych, skontaktuj się z administratorem serwera. Nie jesteśmy w stanie Ci pomóc. Prosimy nie kontaktować się z nami w tej sprawie, ponieważ jest to problem z konfiguracją serwera, a nie wtyczką.

Ponadto REST API musi być włączone i działać bez dodatkowych ograniczeń. Jeśli masz z tym problem, skontaktuj się z programistą, który stworzył Twoją witrynę. Powinien on łatwo znaleźć problem z niedziałającym REST API.

Jak sprawdzić czy wtyczka działa?

Więcej informacji na temat działania wtyczki znajdziesz w naszym podręczniku.

Jak zmienić ścieżkę do przesyłania?

Jest to możliwe przy użyciu następujących typów filtrów do zmiany domyślnych ścieżek. Jest to rozwiązanie dla zaawansowanych użytkowników. Jeśli nie jesteś, pomiń to pytanie.

Ścieżka do głównego katalogu instalacyjnego WordPress (domyślnie ABSPATH):

add_filter( 'webpc_site_root', function( $path ) {
    return ABSPATH;
} );

Ścieżki do katalogów (względem katalogu głównego):

add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'wp-content/uploads';
        case 'webp':
            return 'wp-content/uploads-webpc';
        case 'plugins':
            return 'wp-content/plugins';
        case 'themes':
            return 'wp-content/themes';
    }
    return $path;
}, 10, 2 );

Należy pamiętać, że katalog /uploads-webpc musi znajdować się na tym samym poziomie zagnieżdżenia co katalogi /uploads, /plugins i /themes.

Prefiks w adresie URL katalogu /wp-content/ lub równoważnego (używanego w .htaccess):

add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );

Poniżej znajduje się przykład niestandardowej struktury WordPress:

...
├── web
    ...
    ├── app
    │   ├── mu-plugins
    │   ├── plugins
    │   ├── themes
    │   └── uploads
    ├── wp-config.php
    ...

Użyj następujących filtrów:

add_filter( 'webpc_site_root', function( $path ) {
    return 'C:/WAMP/www/project/web'; // your valid path to root
} );
add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );
add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'app/uploads';
        case 'webp':
            return 'app/uploads-webpc';
        case 'plugins':
            return 'app/plugins';
        case 'themes':
            return 'app/themes';
    }
    return $path;
}, 10, 2 );

Po ustawieniu filtrów przejdź do Ustawienia -> Konwerter multimediów w panelu administracyjnym i kliknij przycisk Zapisz zmiany. Pliki .htaccess z odpowiednimi regułami powinny zostać utworzone w katalogach /uploads i /uploads-webpc.

Jak wykluczyć ścieżki z konwersji?

Aby wykluczyć wybrane katalogi, wpisz je w polu Wykluczone katalogi na karcie Ustawienia zaawansowane w ustawieniach wtyczki.

W tym polu możesz wpisać nazwę katalogu lub ścieżkę. Oto przykłady:
– 2023
– 2024/01
– 2023,2024/01

Aby wykluczyć wybrane pliki, użyj następującego filtra (w tym przypadku z sufiksem „-skipped” w nazwie pliku, np. image-skipped.png):

add_filter( 'webpc_supported_source_file', function( bool $status, string $file_name, string $server_path ): bool {
    $excluded_suffix = '-skipped';
    if ( strpos( $file_name, $excluded_suffix . '.' ) !== false ) {
        return false;
    }
    return $status;
}, 10, 3 );

Argument $server_path to absolutna ścieżka serwera do katalogu lub pliku. Wewnątrz filtrów możesz stosować bardziej skomplikowane reguły, jeśli to konieczne.

Zmiany w wykluczonych katalogach i plikach wchodzą w życie przed konwersją obrazków – nie mają wpływu na już przekonwertowane obrazki. Te obrazki muszą zostać ręcznie usunięte z katalogu: /wp-content/uploads-webpc/.

Wsparcie dla własnych katalogów

Wtyczka domyślnie obsługuje następujące katalogi:
– /gallery
– /plugins
– /themes
– /uploads

Jeśli chcesz dodać obsługę własnego katalogu, dodaj następujący kod do pliku functions.php w katalogu motywu (użyj prawidłowej nazwy katalogu zamiast custom-directory):

add_filter( 'webpc_source_directories', function ( $directories ) {
    $directories[] = 'custom-directory';
    return $directories;
} );

Pamiętaj, że ten katalog musi znajdować się w katalogu /wp-content.

Jak uruchomić konwersję ręcznie?

Domyślnie wszystkie obrazki są konwertowane po kliknięciu przycisku Rozpocznij optymalizację zbiorczą. Ponadto konwersja jest automatyczna po dodaniu nowych plików do multimediów.

Pamiętaj, że nasza wtyczka bierze pod uwagę obrazki generowane przez WordPress. Istnieje wiele wtyczek, które generują na przykład obrazki o innym rozmiarze lub w innej wersji.

Jeśli chcesz zintegrować się ze swoją wtyczką, która generuje obrazki samodzielnie, możesz to zrobić. Nasza wtyczka zapewnia możliwość tego typu integracji. Działa to dla wszystkich obrazków w katalogu /wp-content.

To rozwiązanie dla zaawansowanych użytkowników. Jeśli chcesz zintegrować się z inną wtyczką, najlepiej skontaktować się z autorem tej wtyczki i podać mu informacje o akcjach dostępnych w naszej wtyczce. Pomoże Ci to szybciej znaleźć rozwiązanie.

Możesz ręcznie uruchomić konwersję wybranych plików, możesz użyć akcji, do której przekażesz tablicę z listą ścieżek (muszą to być bezwzględne ścieżki serwera):

do_action( 'webpc_convert_paths', $paths, true );

Alternatywną metodą jest ręczne rozpoczęcie konwersji wybranego załącznika poprzez przekazanie identyfikatora wpisu z multimediów. Pamiętaj, aby uruchomić tę akcję po zarejestrowaniu wszystkich rozmiarów obrazków (tj. po uruchomieniu funkcji add_image_size):

do_action( 'webpc_convert_attachment', $post_id, true );

Aby usunąć ręcznie przekonwertowane pliki, użyj poniższej akcji, podając jako argument tablicę bezwzględnych ścieżek serwera do plików (spowoduje to usunięcie ręcznie przekonwertowanych plików):

do_action( 'webpc_delete_paths', $paths );

Wsparcie dla WP-CLI

Wtyczka obsługuje WP-CLI, co umożliwia szybszą konwersję obrazka z poziomu serwera. Więcej informacji na temat rozpoczęcia korzystania z WP-CLI można znaleźć w Podręczniku. Obsługiwane polecenia opisano poniżej.

Sprawdzanie maksymalnej liczby obrazków do konwersji na witrynie internetowej:

wp converter-for-media calculate

Konwersja wszystkich obrazków:

wp converter-for-media regenerate

Konwersja wszystkich obrazków (z opcją „Wymuś ponowną konwersję wszystkich obrazków”):

wp converter-for-media regenerate --force

Czy wtyczka obsługuje CDN?

Pliki witryny internetowej (pliki WordPress) i obrazki z multimediów muszą znajdować się na tym samym serwerze. Jeśli tak jest, wszystko powinno działać prawidłowo.

Jeżeli tylko Twoje obrazki znajdują się na innym serwerze CDN, niestety prawidłowa operacja nie będzie możliwa, ponieważ takimi obrazkami zarządza inny serwer.

Aktualna lista obsługiwanych serwerów CDN:
– BunnyCDN (przed użyciem zapoznaj się z instrukcją)