<?php
/**
 * @package Polylang
 */

/**
 * Displays a language list
 *
 * @since 1.2
 * @since 3.4 Extends `PLL_Walker` now.
 */
class PLL_Walker_List extends PLL_Walker {
	/**
	 * Database fields to use.
	 *
	 * @see https://developer.wordpress.org/reference/classes/walker/#properties Walker::$db_fields.
	 *
	 * @var string[]
	 */
	public $db_fields = array( 'parent' => 'parent', 'id' => 'id' );

	/**
	 * Outputs one element
	 *
	 * @since 1.2
	 *
	 * @param string   $output            Passed by reference. Used to append additional content.
	 * @param stdClass $element           The data object.
	 * @param int      $depth             Depth of the item.
	 * @param array    $args              An array of additional arguments.
	 * @param int      $current_object_id ID of the current item.
	 * @return void
	 */
	public function start_el( &$output, $element, $depth = 0, $args = array(), $current_object_id = 0 ) { // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
		// Link attributes.
		$link_atts = sprintf(
			'lang="%1$s" hreflang="%1$s" href="%2$s"',
			esc_attr( $element->locale ),
			esc_url( $element->url )
		);

		if ( ! empty( $element->link_classes ) ) {
			$link_atts .= sprintf(
				' class="%s"',
				esc_attr( implode( ' ', $element->link_classes ) )
			);
		}
		if ( ! empty( $element->current_lang ) ) {
			$link_atts .= ' aria-current="true"';
		}

		// Text label.
		if ( $args['show_flags'] && $args['show_names'] ) {
			$label = sprintf(
				'<span style="margin-%1$s:0.3em;">%2$s</span>',
				is_rtl() ? 'right' : 'left',
				esc_html( $element->name )
			);
		} else {
			$label = esc_html( $element->name );
		}

		$output .= sprintf(
			'%5$s<li class="%1$s"><a %2$s>%3$s%4$s</a></li>%6$s',
			esc_attr( implode( ' ', $element->classes ) ),
			$link_atts,
			$element->flag,
			$label,
			'discard' === $args['item_spacing'] ? '' : "\t",
			'discard' === $args['item_spacing'] ? '' : "\n"
		);
	}

	/**
	 * Overrides Walker:walk to set depth argument
	 *
	 * @since 1.2
	 * @since 2.6.7 Use $max_depth and ...$args parameters to follow the move of WP 5.3
	 *
	 * @param array $elements  An array of elements.
	 * @param int   $max_depth The maximum hierarchical depth.
	 * @param mixed ...$args   Additional arguments.
	 * @return string The hierarchical item output.
	 */
	public function walk( $elements, $max_depth, ...$args ) { // phpcs:ignore WordPressVIPMinimum.Classes.DeclarationCompatibility.DeclarationCompatibility
		$this->maybe_fix_walk_args( $max_depth, $args );

		return parent::walk( $elements, $max_depth, $args );
	}
}