Чтение описания функции Wordpress

Question

Я хочу, чтобы понять стандартное описание функции, которое предоставляется для функций Wordpress. В частности, может кто-нибудь объяснить следующий пример из here:

Использование

<?php wp_list_categories($args); ?> 

По умолчанию Использование

<?php $args = array(
    'show_option_all' => , 
    'orderby'   => 'name', 
    'order'    => 'ASC', 
    'show_last_update' => 0, 
    'style'    => 'list', 
    'show_count'   => 0, 
    'hide_empty'   => 1, 
    'use_desc_for_title' => 1, 
    'child_of'   => 0, 
    'feed'    => , 
    'feed_type'   => , 
    'feed_image'   => , 
    'exclude'   => , 
    'exclude_tree'  => , 
    'include'   => , 
    'current_category' => 0, 
    'hierarchical'  => true, 
    'title_li'   => __('Categories'), 
    'number'    => NULL, 
    'echo'    => 1, 
    'depth'    => 0); ?> 

Я догадываюсь, большинство из них, но, в частности, я не могу догадаться:

• Что означает пробел после запятой? Пустая строка?
• Что такое __?
• Как я могу назвать функцию? Ключевое слово, например python, позиционные аргументы или мне нужно передать массив?
• Есть ли что-нибудь еще о описаниях функций Wordpress, которые не рассматриваются в этом примере?

Спасибо,

Chris

Answer 1

• что Запятая будет ошибка синтаксического анализа - в этой документации, я считаю, это просто показывает значение параметра с не по умолчанию.
• Функция __() - это language localization function, которая берет строку буквально на английском языке, и возвращает переведенную строку для локали, определенной приложением.
• функция вызывается передачей в массиве в качестве параметра, определенного как подробное. На самом деле, внутренне это использует wp_parse_args, который позволяет передавать массив, объект или строку с параметрами urlencoded.
• обратите внимание, что это всего лишь idiom, а не как все PHP functions. В этом случае, скорее всего, разработчику функции нужен широкий диапазон необязательных аргументов, а также возможность добавлять новые аргументы, не нарушая устаревший код.