Języki: English – Italiano – 日本語 Português do Brasil – Русский – (Dodaj swój język)

Funkcja Gallery pozwala dodać jedną lub więcej galerii obrazów do swoich postów i stron za pomocą prostego Shortcode. Od wersji WordPress 2.5 i aż do 3.5, shortcode galerii był powszechnie używany w swojej najbardziej podstawowej formie:

Po 3.5, gallery shortcodes domyślnie zawiera identyfikatory obrazów. Jak poniżej:

Należy zauważyć, że ten styl galerii shortcode nie jest nowy w 3.5, wcześniej mogliśmy użyć atrybutu include. Jednakże jest on znacznie łatwiejszy do wygenerowania i zarządzania dzięki nowemu Media Workflow wprowadzonemu w 3.5.

Specyfikowanie identyfikatorów w twoim shortcode pozwala na dołączenie obrazów do twojej galerii, które niekoniecznie są „dołączone” do twojego postu – to znaczy, nie zostały przesłane z twojego postu lub strony. Ta elastyczność pozwala tworzyć i osadzać dowolną liczbę galerii zawierających dowolną liczbę obrazów!

Uwaga: Jeśli zdecydujesz się po prostu użyć wersji „barebones” shortcode w swoim poście lub stronie, wyświetlane będą tylko obrazy, które są „dołączone” do tego postu lub strony.

Usage

Istnieje kilka opcji, które mogą być określone przy użyciu tej składni:

Możesz również wydrukować galerię bezpośrednio w szablonie, tak jak:

 <?php echo do_shortcode(''); ?>

To również działa:

 <?php $gallery_shortcode = ''; print apply_filters( 'the_content', $gallery_shortcode ); ?>

Opcje

Obsługiwane są następujące podstawowe opcje:

orderby Określ sposób sortowania wyświetlanych miniatur. Domyślnie jest to „menu_order”. Opcje:

• menu_order – można zmienić kolejność obrazów w zakładce Galeria w wyskakującym okienku Dodaj media
• title – sortuj według tytułu obrazu w Bibliotece multimediów
• post_date – sortuj według daty/godziny
• rand – sortuj losowo
• ID

order określ kolejność sortowania używaną do wyświetlania miniatur. ASC lub DESC. Na przykład, aby posortować według ID, DESC:

kolumny określ liczbę kolumn. Galeria dołączy znacznik break na końcu każdego wiersza i odpowiednio obliczy szerokość kolumn. Domyślną wartością jest 3. Jeśli kolumny są ustawione na 0, nie będą dołączane żadne podziały wierszy. Na przykład, aby wyświetlić galerię z 4 kolumnami:

id określ identyfikator postu. Galeria wyświetli obrazy, które są dołączone do tego postu. Domyślnym zachowaniem, jeśli nie zostanie określony identyfikator, jest wyświetlanie obrazów dołączonych do bieżącego postu. Na przykład, aby wyświetlić obrazy dołączone do postu 123:

rozmiar określ rozmiar obrazu, który ma być używany do wyświetlania miniatur. Prawidłowe wartości to „thumbnail”, „medium”, „large”, „full” i każdy inny dodatkowy rozmiar obrazu, który został zarejestrowany za pomocą add_image_size(). Domyślną wartością jest „thumbnail”. Rozmiar obrazów dla „miniaturki”, „średniej” i „dużej” można skonfigurować w panelu administracyjnym WordPress w Ustawieniach > Media. Na przykład, aby wyświetlić galerię obrazów o średnim rozmiarze:

Dostępne są pewne zaawansowane opcje:

itemtag nazwa znacznika XHTML używanego do zamknięcia każdego elementu w galerii. Domyślnie jest to „dl”. icontag nazwa znacznika XHTML używanego do zamknięcia każdej ikony miniaturki w galerii. Domyślnie jest to „dt”. captiontag nazwa znacznika XHTML używanego do zamknięcia każdego podpisu. Domyślnie jest to „dd”. Na przykład, aby zmienić znaczniki galerii tak, aby używały znaczników div, span i p:

łącze Określ, gdzie ma znajdować się łącze do obrazu. Domyślna wartość łączy do permalinka załącznika. Opcje:

• file – Link bezpośrednio do pliku obrazu
• none – Brak linku

include comma separated attachment IDs, aby pokazać tylko obrazy z tych załączników.

exclude ID załącznika oddzielone przecinkami wyklucza obrazy z tych załączników. Proszę zauważyć, że include i exclude nie mogą być użyte razem.

Deweloperzy – Rzeczy do rozważenia

Domyślnym oczekiwanym zachowaniem dla galerii, która nie ma podanych jawnych identyfikatorów, jest dodanie wszystkich obrazów, które mają przypisany post jako post parent. Innymi słowy, dodaj wszystkie obrazy, które zostały przesłane za pomocą przycisku / linku „Dodaj media” na ekranie edycji tego postu. Pamiętaj, że oznacza to również, że każdy załącznik dodany później do tego postu będzie interpretowany jako część galerii. Nie ważne czy był on wyświetlany jako zwykły załącznik czy nie.

To powinien być domyślny błąd, jeśli nie podano żadnego argumentu: …lorem ipsum…

$attachments = get_children( array('post_parent' => $attr,'post_status' => 'inherit','post_type' => 'attachment','post_mime_type' => 'image','order' => $attr,'orderby' => $attr,) );

I przestań używać extract() na shortcode_atts() (lub gdziekolwiek indziej). IDE nie są w stanie tego prześledzić.