Jak rozszerzyć Visual Composer o niestandardowe elementy treści

Aby przesłonić dowolny element w programie Visual Composer, najpierw musisz skopiować plik szablonu z folderu wtyczki Visual Composer (js_composer)> include> templates do  folderu yourtheme> vc_templates . Weźmy np. pliki:

  1. vc_column.php
  2. vc_column_text.php
  3. vc_row.php
  4. vc_video.php

Nazywanie jest tutaj bardzo ważne. Szablony te powinny mieć taką samą nazwę, jak w domyślnym folderze wtyczek VC.

Po skopiowaniu pliku szablonu możesz go zastąpić. Zobaczmy na przykład, co znajduje się w pierwszym pliku vc_columns.php. Jeśli jesteś obeznany z tworzeniem krótkich kodów, nie będzie tu nic nowego.

Strukturę pliku można podzielić na trzy części:

  1. Wyodrębnianie atrybutów shortcode
  2. Przygotowanie ustawień wyjściowych
  3. Wyświetlenie struktury shortcode

Ale co jeśli chcesz dodać lub usunąć istniejące atrybuty shortcode, jak sobie z tym poradzisz? Poznaj trzy nowe funkcje:

Ta funkcja usuwa parametr shortcode z istniejącego lub niestandardowego elementu. Aby usunąć atrybut, wybierz na przykład konkretny shortcode z nazwą, na przykład vc_columni nazwą atrybutu el_class.

				
					vc_remove_param( "vc_column", "el_class" );
				
			

Ta funkcja dodaje nowe parametry do istniejącego lub niestandardowego elementu. Podobnie jak w przypadku  vc_remove_param()funkcji, celuj na określony skrót z jego nazwą i na przykład vc_columndołącz tablicę parametrów:

				
					vc_add_param('vc_column', array(
    "type"       => "dropdown",
    "class"      => "",
    "heading"    => "Animate",
    "param_name" => "animate",
    "value"      => array(
    "False"  => 'false',
    "True"   => 'true'
    )
));
				
			

Ta funkcja jest podobna do vc_add_param(), ale pozwala na dodanie wielu parametrów do jednego elementu. Listę wszystkich typów parametrów można znaleźć tutaj .

Aby dodać lub usunąć nowe parametry, a także dodać nowe elementy, musisz edytować plik integracji.

  1. Zaczynamy od wyłączenia edytora front-end. Frontendowy edytor to naprawdę fajna funkcja, ale nasze niestandardowe elementy go nie obsługują. To Ty, jako programista motywów, niezależnie od tego, czy chcesz wspierać edytory front-end i / lub back-end.
  2. Usuń wszystkie niepotrzebne lub nieobsługiwane parametry z elementów docelowych vc_remove_param();
  3. Dodaj nowe parametry do istniejących elementów za pomocą  funkcji vc_add_param();lub vc_add_params();.
  4. Następnie dodaj nowe elementy …