functions.php : ligne par ligne

Cet article est destiné aux personnes ayant quelques connaissances en php et en WP (thème, modèle, …).

La fonction twentythirteen_xilidev_setup actionnée par le filtre “after_setup_theme” après (11) celui du parent va permettre de mettre en place les bons fichiers, instancier la classe “xili_language_theme_options” avec des paramètres personnalisés (nom du thème parent, nom du domaine pour la traduction,…) et rendre compte d’éventuelles erreurs. La classe “xili_language_theme_options_admin” n’est activée que du côté admin.

6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
define( 'TWENTYTHIRTEEN_XILI_VER', '1.0'); // as style.css
 
// main initialisation functions
 
function twentythirteen_xilidev_setup () {
 
	$theme_domain = 'twentythirteen';
 
	load_theme_textdomain( $theme_domain, STYLESHEETPATH . '/langs' ); // now use .mo of child
 
	$xl_required_version = false;
 
	if ( class_exists('xili_language') ) { // if temporary disabled
 
		$xl_required_version = version_compare ( XILILANGUAGE_VER, '2.8.7', '>' );
 
		global $xili_language;
 
		$xili_language_includes_folder = $xili_language->plugin_path .'xili-includes'; 
 
		$xili_functionsfolder = get_stylesheet_directory() . '/functions-xili' ;
 
		if ( file_exists( $xili_functionsfolder . '/multilingual-classes.php') ) {
			require_once ( $xili_functionsfolder . '/multilingual-classes.php' ); // xili-options created by developers
 
		} elseif ( file_exists( $xili_language_includes_folder . '/theme-multilingual-classes.php') ) {
 
			require_once ( $xili_language_includes_folder . '/theme-multilingual-classes.php' ); // ref xili-options based in plugin
		}
 
		if ( file_exists( $xili_functionsfolder . '/multilingual-functions.php') ) {
			require_once ( $xili_functionsfolder . '/multilingual-functions.php' );
		}
 
		if ( file_exists( $xili_functionsfolder . '/multilingual-permalinks.php') && $xili_language->is_permalink ) {
			require_once ( $xili_functionsfolder . '/multilingual-permalinks.php' ); // require subscribing premium services
		}
 
 
	//register_nav_menu ( 'toto', 'essai' );
 
		global $xili_language_theme_options ; // used on both side
	// Args dedicaced to this theme named Twenty Thirteen
		$xili_args = array (
	 		'customize_clone_widget_containers' => true, // comment or set to true to clone widget containers
	 		'settings_name' => 'xili_2013_theme_options', // name of array saved in options table
	 		'theme_name' => 'Twenty Thirteen',
	 		'theme_domain' => $theme_domain,
	 		'child_version' => TWENTYTHIRTEEN_XILI_VER
		);
 
		if ( is_admin() ) {
 
		// Admin args dedicaced to this theme
 
			$xili_admin_args = array_merge ( $xili_args, array (
		 		'customize_adds' => true, // add settings in customize page
		 		'customize_addmenu' => false, // done by 2013
		 		'capability' => 'edit_theme_options'
			) );
			if ( class_exists ( 'xili_language_theme_options_admin' )  ) {
				$xili_language_theme_options = new xili_language_theme_options_admin ( $xili_admin_args );
				$class_ok = true ;
			} else {
				$class_ok = false ;
			}
 
 
		} else { // visitors side - frontend
 
			if ( class_exists ( 'xili_language_theme_options' )  ) {
				$xili_language_theme_options = new xili_language_theme_options ( $xili_args );
				$class_ok = true ;
			} else {
				$class_ok = false ;
			}
		}
	}
 
	// errors and installation informations
 
	if ( ! class_exists( 'xili_language' ) ) {
 
		$msg = '
		<div class="error">
			<p>' . sprintf ( __('The %s child theme requires xili-language plugin installed and activated', $theme_domain ), get_option( 'current_theme' ) ).'</p>
		</div>';
 
	} elseif ( $class_ok === false )  {
 
		$msg = '
		<div class="error">
			<p>' . sprintf ( __('The %s child theme requires <em>xili_language_theme_options</em> class to set multilingual features.', $theme_domain ), get_option( 'current_theme' ) ).'</p>
		</div>';
 
	} elseif ( $xl_required_version )  {
 
		$msg = '
		<div class="updated">
			<p>' . sprintf ( __('The %s child theme was successfully activated with xili-language.', $theme_domain ), get_option( 'current_theme' ) ).'</p>
		</div>';
 
	} else {
 
		$msg = '
		<div class="error">
			<p>' . sprintf ( __('The %s child theme requires xili-language version 2.8.8+', $theme_domain ), get_option( 'current_theme' ) ).'</p>
		</div>';
	}
	// after activation and in themes list	
	if ( isset( $_GET['activated'] ) || ( ! isset( $_GET['activated'] ) && ( ! $xl_required_version || ! $class_ok ) ) )
		add_action( 'admin_notices', $c = create_function( '', 'echo "' . addcslashes( $msg, '"' ) . '";' ) );
 
	// end errors...	
 
}
add_action( 'after_setup_theme', 'twentythirteen_xilidev_setup', 11 );

Le message en couleur jaune indique que tout va bien, les messages en rouge indique que l’extension xili-language n’est pas activée ou que sa version est ancienne. Idem si la classe n’est pas présente.

La function ‘special_head’ actionnée par le filtre ‘wp_head’ va agir sur la circonstance où l’on décide d’avoir un formulaire de recherche enrichi des langues disponibles pour cibler cette recherche. Une autre tâche est – selon les préférences – d’injecter dans une balise style les lignes css dans le header pour avoir le nom des langues remplacé par une image (drapeau).

173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
/**
 * define when search form is completed by radio buttons to sub-select language when searching
 *
 */
function special_head() {
 
	// to change search form of widget
	// if ( is_front_page() || is_category() || is_search() )
	if ( is_search() ) {
	 	add_filter('get_search_form', 'my_langs_in_search_form_2013', 10, 1); // in multilingual-functions.php
	}
	$xili_theme_options = get_theme_xili_options() ; 
 
	if ( !isset( $xili_theme_options['no_flags'] ) || $xili_theme_options['no_flags'] != '1' ) {
		twentythirteen_flags_style(); // insert dynamic css
	}
}
if ( class_exists('xili_language') )  // if temporary disabled
	add_action( 'wp_head', 'special_head', 11);
 
/**
 * dynamic style for flag depending current list and option no_flags
 *
 * @since 1.0.2 - add #access
 *
 */
function twentythirteen_flags_style () {
 
	if ( class_exists('xili_language') ) {
		global $xili_language ;
		$language_xili_settings = get_option('xili_language_settings'); 
		if ( !is_array( $language_xili_settings['langs_ids_array'] ) ) { 
			$xili_language->get_lang_slug_ids(); // update array when no lang_perma 110830 thanks to Pierre
			update_option( 'xili_language_settings', $xili_language->xili_settings );
			$language_xili_settings = get_option('xili_language_settings');
		}
 
		$language_slugs_list =  array_keys ( $language_xili_settings['langs_ids_array'] ) ;
 
		?>
		<style type="text/css">
		<?php 
 
		$path = get_stylesheet_directory_uri();
 
		$ulmenus = array();
		foreach ( $language_slugs_list as $slug ) {
			echo "ul.nav-menu li.menu-separator { margin:0; }\n";
			echo "ul.nav-menu li.lang-{$slug} a { background: transparent url('{$path}/images/flags/{$slug}.png') no-repeat center 16px; margin:0;}\n";
			echo "ul.nav-menu li.lang-{$slug}:hover {background: #AD9065}\n"; // find menu bk
			echo "ul.nav-menu li.lang-{$slug} a:hover {background: transparent url('{$path}/images/flags/{$slug}.png') no-repeat center 17px !important;}\n";
			$ulmenus[] = "ul.nav-menu li.lang-{$slug} a";
		} 
			echo implode (', ', $ulmenus ) . " {text-indent:-9999px; width:24px;  }\n";
		?>
		</style>
		<?php
 
	}
}

Le thème Twenty Thirteen autorise avec son filtre ‘twentythirteen_credits’ de personnaliser le crédit en bas de page.

323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
function twentythirteen_xili_credits () {
	printf( __("Multilingual child theme of Twenty Thirteen by %s", 'twentythirteen' ),"<a href=\"http://dev.xiligroup.com\">dev.xiligroup</a> - " );
}
 
add_action ('twentythirteen_credits','twentythirteen_xili_credits');
 
 
// examples to help authors
 
// propagate post_formats
add_action( 'xl_propagate_post_attributes', 'xili_propagate_post_format', 10, 2);
 
function xili_propagate_post_format ( $from_post_ID, $post_ID ) {
	if ( $format = get_post_format( $from_post_ID ) ){
		set_post_format( (int)$post_ID , $format);
	}
}
 
// propagate page templates
add_action( 'xl_propagate_post_attributes', 'xili_propagate_page_template', 10, 2);
 
function xili_propagate_page_template ( $from_post_ID, $post_ID ) {
	if ( 'page' == get_post_type( $from_post_ID ) ) { // post_type_supports( 'page', 'page-attributes' );
 
		$template = get_post_meta ( $from_post_ID, '_wp_page_template', true ) ;
		update_post_meta ( $post_ID, '_wp_page_template', $template );
 
	}
}

La version xili-language propose le filtre ‘xl_propagate_post_attributes’. Donc selon le thème et la politique éditoriale, il est possible de choisir ce qui est copié lors de la création d’un article dans une autre langue. Le travail de l’auteur/traducteur est ainsi facilité : ici le post_format est recopié, idem pour le template en cas de page. Il est tout à fait possible d’imaginer que le format (ou le template ) ne soit pas le même selon chaque langue… c’est l’avantage de pourvoir coder.

2013-05-09 MS

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

*