Przejdź do treści

Dennis · 14 października 2026

Blockstudio 7.7

Blockstudio Wersja 7.7 dodaje wirtualne trasy dla dokumentów bez wpisu WordPress, usprawnia ukierunkowane kompilacje wstępnego renderowania i zwiększa niezawodność edycji oraz renderowania istniejących bloków. Rozszerza też kontrole tagów bloków w PHPStan i poprawia dostępność dołączonych komponentów UI.

Praca z plikami pozostaje bez zmian. Bloki są renderowane na podstawie swoich szablonów, a strony oparte na plikach zmieniają się za pośrednictwem jawnej synchronizacji CLI lub API. To wydanie nie wprowadza automatycznej synchronizacji stron podczas żądań odwiedzających ani administratorów.

W skrócie:

  • Wirtualne trasy: udostępniaj galerię komponentów, katalog lub inny kompletny dokument bez tworzenia wpisu ani pisania własnego procedury obsługi przekierowań.
  • Ukierunkowane kompilacje wstępnego renderowania: kompilacje HTTP zapisują pliki źródłowe używane przez każdą stronę, dzięki czemu kolejna kompilacja może renderować tylko zmienione trasy.
  • Zachowywanie pamięci podręcznej: udostępniaj wycofane arkusze stylów stronom zapisanym w pamięci podręcznej oraz sprawdzaj lub usuwaj nieużywane wpisy mapy wczesnego udostępniania.
  • Niezawodność edytora: bloki zaznaczone jednocześnie zachowują własne wartości, cofanie i ponawianie działa dla RichText oraz pól panelu bocznego, a odziedziczony kontekst pozostaje przypisany do właściwego bloku.
  • Wierność treści plików: zagnieżdżone listy, elementy sekcji, wbudowany HTML, shortcode’y i escapowane atrybuty zachowują się podczas parsowania i renderowania.
  • Usprawnienia PHPStan: tagi z prefiksami, aliasy, mapowane elementy stron i zmienne szablonów są sprawdzane względem definicji danego projektu.
  • Dostępne UI: kontrolki poprawnie udostępniają swój stan, etykiety przełączają właściwe pola, a komponenty list i tabel używają prawidłowej struktury HTML.
  • Tłumaczenia: zainstalowane tłumaczenia JavaScript są wczytywane w edytorze i przeglądzie administracyjnym, także w przypadku wcześniej nieprzetłumaczonych kontrolek pól.

Wirtualne trasy

Niektóre strony pochodzą z danych, a nie z wpisu zarządzanego przez edytor. Na przykład dokumentacja komponentu może wymagać własnego URL i tytułu dokumentu, ale nie wpisu w wp_posts.

Zarejestruj ten dokument za pomocą Blockstudio\Virtual_Routes:

PHP
add_action('init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function () {
            get_header();
            echo bs_block([
                'name' => 'mytheme/card',
                'data' => ['heading' => 'Example card'],
            ]);
            get_footer();
        },
        ['title' => 'Component gallery']
    );
});

Trasa udostępnia /components/. Jej funkcja zwrotna działa w buforze wyjściowym Blockstudio, więc renderowane bloki otrzymują style, skrypty, dołączone zasoby UI i wyjście Tailwind w ramach standardowego potoku. WordPress nie zamienia dopasowanej trasy we 404 ani nie przekierowuje jej do wpisu.

Dla grupy adresów URL ustaw prefix na true i przekaż funkcję zwrotną match. Funkcja otrzymuje ścieżkę poniżej trasy i zwraca wartość potrzebną rendererowi. Zwrócenie null lub false pozostawia obsługę żądania dla WordPress. Użyj urls, aby wyświetlić ścieżki, które statyczna kompilacja wstępnego renderowania powinna uwzględnić. Pojedyncza trasa bez prefiksu domyślnie uwzględnia własną ścieżkę.

Virtual_Routes::urls() zwraca bezwzględne adresy URL dla integracji tworzących mapę witryny. Nie dodaje automatycznie wirtualnych dokumentów do mapy witryny wpisów WordPress.

Pełny Wirtualne trasy i opcje opisano w API.

Precyzyjniejsze kompilacje wstępnego renderowania

Kompilacje w trybie grafu uruchamiane dla HTTP zapisują teraz pliki używane przez każdą trasę: szablon WordPress, szablony i zasoby renderowanych bloków, definicje stron opartych na plikach i układy oraz zależności dodane przez blockstudio/render/dependencies.

Podczas kolejnej kompilacji build_plan() porównuje te zależności. Zmiana szablonu bloku oznacza zależne od niego trasy do ponownego renderowania bez przebudowy wszystkich niepowiązanych stron. Zmiany wspólnej konfiguracji nadal wpływają na całą kompilację, a nowe lub wygasłe trasy są renderowane jak dotychczas.

Zmiany dotyczące wyłącznie bazy danych nie są zależnościami plikowymi. Wdrożenie, które ma uwzględnić opcję, wpis lub inną wartość z bazy danych, musi wymusić kompilację albo jawnie wyrenderować odpowiednie adresy URL.

Wydanie naprawia też zmiany identyfikatorów kompilacji podczas pierwszego renderowania, nieaktualne mapy wczesnego udostępniania z pamięci podręcznej kodu operacyjnego oraz wykluczanie prawidłowych adresów URL tylko dlatego, że ich ścieżka zawiera search lub preview. Żądania Markdown używające Accept: text/markdown omijają buforowane HTML, a odpowiednie odpowiedzi wysyłają Vary: Accept.

Statyczne wstępne renderowanie uwzględnia teraz filtry zarejestrowane przez aktywny motyw przy podejmowaniu decyzji o dołączeniu swoich haków. Motyw może wyłączyć tę funkcję, nawet jeśli wcześniejsze sprawdzenie ustawień pozostawiło ją aktywną.

Zobacz Statyczne wstępne renderowanie.

Zachowywanie pamięci podręcznej i jej konserwacja

Strona HTML zapisana w pamięci podręcznej może być dostępna dłużej niż tożsamość środowiska wykonawczego, w którym skompilowano jej arkusz stylów. cache.namespaceGrace określa, jak długo wycofane przestrzenie nazw pozostają dostępne po ich pierwszym wykryciu podczas czyszczenia:

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

Ten przykład zachowuje wycofane pliki przez dziewięć dni. Wartość domyślna to jeden dzień. Aktywne przestrzenie nazw oraz przestrzenie obsługujące wdrożone artefakty wstępnego renderowania są chronione przed czyszczeniem wycofanych elementów.

Mapa wczesnego udostępniania ma też polecenia do kontroli i czyszczenia:

Powłoka
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune

Zgłaszają i usuwają wpisy dotyczące usuniętych witryn lub brakujących katalogów. Usunięcie witryny w instalacji wielowitrynowej usuwa również jej wpisy. Brakujące dokumenty tras są zgłaszane osobno, zamiast powodować usunięcie całego wpisu prawidłowej witryny.

Wskazówki dotyczące czasu przechowywania znajdziesz w Buforowanie, a polecenia konserwacji mapy — w konserwacja mapy.

Bardziej niezawodny edytor

Edycja bloku w wielokrotnym zaznaczeniu aktualizuje teraz tylko ten blok. Podczas zapisywania każdy blok zachowuje własną treść, klucze, metadane i blokady, zamiast kopiować atrybuty między zaznaczonymi blokami.

Wartości RichText znajdują się bezpośrednio w atrybutach bloku, więc Gutenberg może uwzględniać je przy cofaniu i ponawianiu. Pola panelu bocznego korzystają z tej samej historii. InnerBlocks templateLock="false" jest przekazywane jako wartość logiczna i odblokowuje treść nawet wtedy, gdy obszar nadrzędny jest zablokowany.

Wstępne pobieranie otrzymuje identyfikator i typ edytowanego wpisu, więc szablony mogą odczytać prawidłowe metadane już przy pierwszym renderowaniu. Identyczne bloki potomne u różnych bloków nadrzędnych zachowują oddzielny odziedziczony kontekst we wstępnie pobranych danych i pamięciach podręcznych renderowania. Zmiany atrybutów lub kontekstu podczas początkowego żądania nie powodują już nieaktualnego podglądu.

Blockstudio nie wstawia już ukrytych elementów znaczników renderowania między głównymi elementami bloków. Selektory sąsiedniego rodzeństwa, takie jak .card + .card, widzą teraz w edytorze te same relacje między elementami co na frontendzie, a podglądy renderowania edytora i wstawiania pozostają odrębne.

Bezpieczniejsze przechowywanie opcji dla całej witryny

Pola oparte na opcjach nadal udostępniają wartości dla całej witryny, ale zapisywanie wpisu nie zapisuje już bezwarunkowo każdej zachowanej kopii tych pól:

  • Zapisy wersji roboczych, oczekujących, prywatnych i zaplanowanych nie zapisują aktywnych opcji witryny.
  • Zapis opublikowanego wpisu uwzględnia przekazane pola zmienione podczas tej edycji.
  • Zapis zmieniający tylko tytuł starej kopii nie przywraca nowszej wartości dla całej witryny.
  • Brakujące pola i usunięte bloki nie usuwają istniejących opcji.
  • Jawne null usuwa opcję. Puste ciągi, false, zero i puste tablice pozostają prawidłowymi wartościami.

To główna zmiana w działaniu, którą należy sprawdzić podczas aktualizacji. Jeśli integracja używała prywatnego lub roboczego wpisu do aktualizacji aktywnej opcji, zapisz tę opcję jawnie albo użyj opublikowanego wpisu konfiguracji. Ograniczenie do opublikowanych wpisów nie dotyczy przechowywania w metadanych wpisów.

Pełne zasady zapisywania opisano w Przechowywanie.

Treść plików pozostaje nienaruszona

Potok HTML-bloki zachowuje więcej napisanej przez Ciebie struktury:

  • Zagnieżdżone listy stają się blokami list wewnętrznych elementu nadrzędnego. Klasy list i elementów są zachowywane; zwykłe płaskie listy nadal mają dotychczasowy wynik.
  • main, header, footer, article i aside stają się blokami grup, które zachowują swoje elementy zamiast surowego HTML omijającego renderowanie bloków.
  • Mapowane akapity rich text zachowują znaczniki wbudowane, akapity zawierające tylko obraz są przekształcane w mapowany blok obrazu, a tagi shortcode’ów zachowują swoją treść.
  • Escapowane atrybuty są dekodowane i ponownie escapowane tylko raz, również atrybuty w InnerBlocks, RichText i elemencie useBlockProps.
  • Znaki większości wewnątrz cytowanych atrybutów tagów samozamykających się są akceptowane.
  • Globalne atrybuty HTML trafiają do głównego elementu bloku Blockstudio, jeśli blok nie deklaruje ich jako pól. wp bs pages sync zgłasza zapisane atrybuty, które nie są renderowane.

Strony oparte na Blade, wzorce i szablony Edytora witryny są teraz renderowane przez Blockstudio\Blade_Renderer, co zapewnia obsługę wersji od 8 do 12 illuminate/view. Rejestrowane są wszystkie pliki rozszerzeń kierowane do tego samego bloku, a ich priorytet, pola grup i listy celów są zgodne z udokumentowanym schematem.

Śledzone są również zagnieżdżone zależności SCSS. Edycja fragmentu zaimportowanego przez inny fragment zmienia wersję zależnego arkusza stylów i uruchamia ponowną kompilację.

Usprawnienia PHPStan

Osobno instalowany pakiet blockstudio/phpstan rozszerza sprawdzanie poprawności tagów bloków o tagi z prefiksami i aliasy, mapowane elementy stron, układy, dołączone bloki UI oraz opcjonalnie inne źródła PHP projektu. Rozpoznawanie przestrzeni nazw odpowiada działaniu środowiska wykonawczego, również w przypadku nazw zawierających łączniki, a przekazywane dalej globalne atrybuty HTML są akceptowane.

Zmienne szablonu bloku, takie jak $a, $block i $context, są traktowane przez Blockstudio jako zdefiniowane. Typy pól są zachowywane przy operatorze null coalescing i isset() w ramach PHPStan 2.3, a szablon, który przypisuje własne $a, zachowuje przypisany typ.

Te zmiany są dostępne w blockstudio/phpstan 0.1.9. Zaktualizuj pakiet niezależnie od wtyczki; wymaga on wersji PHPStan 2.1.47 lub nowszej:

Powłoka
composer require --dev blockstudio/phpstan:^0.1.9

Informacje o konfiguracji i presetach analizy znajdziesz w PHPStan.

Dostępność i tłumaczenia

Przyciski uruchamiające dołączone komponenty UI udostępniają ich rozwinięty stan. Etykiety pól wyboru, przełączników i przycisków opcji opisują te kontrolki i pozwalają je przełączać. Okruszki nawigacyjne, paginacja, menu nawigacyjne i tabele nie wstawiają już nieprawidłowych elementów opakowujących między listy lub tabele a ich elementy potomne.

Przełączniki widoczności hasła udostępniają stan wciśnięcia i mają większy obszar klikania. Pola wejściowe akceptują autocomplete, a pola haseł — jawny identyfikator i dostępną etykietę. Widoki karuzeli można zaznaczyć klawiaturą, a animacje wskaźników ładowania i szkieletów respektują preferencje ograniczenia ruchu.

Edytor i przegląd administracyjny wczytują zainstalowane tłumaczenia JavaScript dla domeny tekstowej blockstudio. Menu atrybutów i teksty zastępcze, działania wyskakującego okna kodu oraz oznaczenia obrazów i plików można teraz tłumaczyć. Ciągi bez tłumaczenia pozostają po angielsku.

Zobacz bibliotekę UI oraz konfigurację tłumaczeń.

Dokumentacja i aktualizacja

Dokumentacja zawiera nowe przewodniki dotyczące witryn dokumentacji, Content Sync, szablonów Site Editor, tagów bloków, wysp, niestandardowych typów pól, wdrażania, prerenderowania, konfiguracji rejestru, narzędzi analitycznych i ekranów aplikacji UI. Przewodnik migracji ACF uwzględnia aktualną rejestrację ACF i Block Bindings.

Przykłady niestandardowego wypełniania używają teraz obsługiwanego filtra z jednym argumentem i nazwanym zbiorem danych. Dokumentacja zasobów wyjaśnia kolejność arkuszy stylów frontendu oraz sposób ładowania nadpisań motywu po CSS bloku. Instalacje dla współtwórców używają publicznego pakietu Font Awesome bez danych uwierzytelniających do rejestru.

PHP 8.2 i WordPress 6.7 pozostają minimalnymi wymaganiami. Wirtualne trasy i nowe polecenia konserwacyjne są dostępne bez zmian w istniejących kolekcjach stron. Zapoznaj się z powyższymi zasadami zapisywania opcji, zaktualizuj osobny pakiet PHPStan, jeśli go używasz, i nadal jawnie uruchamiaj synchronizację stron.

7.7.1 Dalsze działania

Poprawka 7.7.1 sprawia, że wyniki synchronizacji są bardziej przejrzyste i bezpieczniejsze. Scalone wpisy na podstawie kluczy, które nie zmieniają wpisu, nie tworzą już nowej wersji ani nie aktualizują daty modyfikacji. Zachowywane są istniejące statusy publikacji, raportowane są zastąpienia tytułów i uproszczonych nazw plików, a zablokowane lub usunięte strony są wymieniane w raporcie CLI. Content Sync oznacza treści stron zarządzane przez Page Sync i zachowuje istniejące kopie do przeglądu. Poprawka chroni też atrybuty zarządzane przez WordPress przed konfliktami z identyfikatorami pól oraz zachowuje klasy edytora dodane przez inne filtry.