]['facebook'] ) ) { $this->facebook = $languages[ $this->locale ]['facebook']; } } } /** * Get the flag informations: * * @since 2.6 * * @param string $code Flag code. * @return array { * Flag informations. * * @type string $url Flag url. * @type string $src Optional, src attribute value if different of the url, for example if base64 encoded. * @type int $width Optional, flag width in pixels. * @type int $height Optional, flag height in pixels. * } */ public static function get_flag_informations( $code ) { $flag = array( 'url' => '' ); // Polylang builtin flags. if ( ! empty( $code ) && file_exists( POLYLANG_DIR . ( $file = '/flags/' . $code . '.png' ) ) ) { $flag['url'] = plugins_url( $file, POLYLANG_FILE ); // If base64 encoded flags are preferred. if ( ! defined( 'PLL_ENCODED_FLAGS' ) || PLL_ENCODED_FLAGS ) { list( $flag['width'], $flag['height'] ) = getimagesize( POLYLANG_DIR . $file ); $file_contents = file_get_contents( POLYLANG_DIR . $file ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents $flag['src'] = 'data:image/png;base64,' . base64_encode( $file_contents ); // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_encode } } /** * Filters flag informations: * * @since 2.4 * * @param array $flag { * Information about the flag. * * @type string $url Flag url. * @type string $src Optional, src attribute value if different of the url, for example if base64 encoded. * @type int $width Optional, flag width in pixels. * @type int $height Optional, flag height in pixels. * } * @param string $code Flag code. */ $flag = apply_filters( 'pll_flag', $flag, $code ); $flag['url'] = esc_url_raw( $flag['url'] ); if ( empty( $flag['src'] ) ) { $flag['src'] = esc_url( set_url_scheme( $flag['url'], 'relative' ) ); } return $flag; } /** * Sets flag_url and flag properties. * * @since 1.2 * * @return void */ public function set_flag() { $flags = array( 'flag' => self::get_flag_informations( $this->flag_code ) ); // Custom flags? $directories = array( PLL_LOCAL_DIR, get_stylesheet_directory() . '/polylang', get_template_directory() . '/polylang', ); foreach ( $directories as $dir ) { if ( file_exists( $file = "{$dir}/{$this->locale}.png" ) || file_exists( $file = "{$dir}/{$this->locale}.jpg" ) || file_exists( $file = "{$dir}/{$this->locale}.svg" ) ) { $flags['custom_flag']['url'] = content_url( '/' . str_replace( WP_CONTENT_DIR, '', $file ) ); break; } } /** * Filters the custom flag informations. * * @param array $flag { * Information about the custom flag. * * @type string $url Flag url. * @type string $src Optional, src attribute value if different of the url, for example if base64 encoded. * @type int $width Optional, flag width in pixels. * @type int $height Optional, flag height in pixels. * } * @param string $code Flag code. * * @since 2.4 */ $flags['custom_flag'] = apply_filters( 'pll_custom_flag', empty( $flags['custom_flag'] ) ? null : $flags['custom_flag'], $this->flag_code ); if ( ! empty( $flags['custom_flag']['url'] ) ) { if ( empty( $flags['custom_flag']['src'] ) ) { $flags['custom_flag']['src'] = esc_url( set_url_scheme( $flags['custom_flag']['url'], 'relative' ) ); } $flags['custom_flag']['url'] = esc_url_raw( $flags['custom_flag']['url'] ); } else { unset( $flags['custom_flag'] ); } /** * Filters the flag title attribute. * Defaults to the language name. * * @since 0.7 * * @param string $title The flag title attribute. * @param string $slug The language code. * @param string $locale The language locale. */ $title = apply_filters( 'pll_flag_title', $this->name, $this->slug, $this->locale ); foreach ( $flags as $key => $flag ) { $this->{$key . '_url'} = empty( $flag['url'] ) ? '' : $flag['url']; /** * Filters the html markup of a flag. * * @since 1.0.2 * * @param string $flag Html markup of the flag or empty string. * @param string $slug Language code. */ $this->{$key} = apply_filters( 'pll_get_flag', self::get_flag_html( $flag, $title, $this->name ), $this->slug ); } } /** * Get HTML code for flag. * * @since 2.7 * * @param array $flag Flag properties: src, width and height. * @param string $title Optional title attribute. * @param string $alt Optional alt attribute. * @return string */ public static function get_flag_html( $flag, $title = '', $alt = '' ) { if ( empty( $flag['src'] ) ) { return ''; } $alt_attr = empty( $alt ) ? '' : sprintf( ' alt="%s"', esc_attr( $alt ) ); $width_attr = empty( $flag['width'] ) ? '' : sprintf( ' width="%s"', (int) $flag['width'] ); $height_attr = empty( $flag['height'] ) ? '' : sprintf( ' height="%s"', (int) $flag['height'] ); $style = ''; $sizes = array_intersect_key( $flag, array_flip( array( 'width', 'height' ) ) ); if ( ! empty( $sizes ) ) { array_walk( $sizes, function ( &$value, $key ) { $value = sprintf( '%s: %dpx;', esc_attr( $key ), (int) $value ); } ); $style = sprintf( ' style="%s"', implode( ' ', $sizes ) ); } return sprintf( '', $flag['src'], $alt_attr, $width_attr, $height_attr, $style ); } /** * Returns the html of the custom flag if any, or the default flag otherwise. * * @since 2.8 * * @return string */ public function get_display_flag() { return empty( $this->custom_flag ) ? $this->flag : $this->custom_flag; } /** * Returns the url of the custom flag if any, or the default flag otherwise. * * @since 2.8 * * @return string */ public function get_display_flag_url() { return empty( $this->custom_flag_url ) ? $this->flag_url : $this->custom_flag_url; } /** * Updates post and term count. * * @since 1.2 * * @return void */ public function update_count() { wp_update_term_count( $this->term_taxonomy_id, 'language' ); // Posts count. wp_update_term_count( $this->tl_term_taxonomy_id, 'term_language' ); // Terms count. } /** * Set home_url and search_url properties. * * @since 1.3 * * @param string $search_url Home url to use in search forms. * @param string $home_url Home url. * @return void */ public function set_home_url( $search_url, $home_url ) { $this->search_url = $search_url; $this->home_url = $home_url; } /** * Sets the scheme of the home url and the flag urls. * * This can't be cached across pages. * * @since 2.8 * * @return void */ public function set_url_scheme() { $this->home_url = set_url_scheme( $this->home_url ); $this->search_url = set_url_scheme( $this->search_url ); // Set url scheme, also for the flags. $this->flag_url = set_url_scheme( $this->flag_url ); if ( ! empty( $this->custom_flag_url ) ) { $this->custom_flag_url = set_url_scheme( $this->custom_flag_url ); } } /** * Returns the language locale. * Converts WP locales to W3C valid locales for display. * * @since 1.8 * * @param string $filter Either 'display' or 'raw', defaults to raw. * @return string */ public function get_locale( $filter = 'raw' ) { return 'display' === $filter ? $this->w3c : $this->locale; } }