Моя проблема с @package
и @subpackage
.
Я пошел по предложенной ссылке (Для чего нужны комментарии к пакетам и подпакетам? ). Там я не нашел ничего, что можно было бы применить к своей проблеме, но вместо этого ответил: «Это теги PHPDoc, используемые для создания содержательной (и автоматической) документации кода». Вот что у меня сейчас:
/**
* Contains a list of all custom action hooks and corresponding functions defined for abc.
* This file is included in functions.php:
*
* @package theme-name
* @subpackage Functions
*/
Это не детская тема двадцати десяти. Существует папка в папке имя-тема: functions
. Моя дочерняя тема находится в другой папке. Я сохранил functions.php
файл в папке моей дочерней темы. Ничего не происходит (смена содержимого), когда я меняю подпакет на имя своей папки или оставляю там Functions
слово.
Что я должен положить сюда?
/**
* Contains a list of all custom action hooks and corresponding functions defined for abc.
* This file is included in functions.php:
*
* @package theme-name
* @subpackage ???
*/
источник
include()
илиrequire()
в свой основнойfunctions.php
файл, чтобы включить новый файл PHP? Если нет, то он никогда не будет загружен. Я бы сказал, чтобы открыть новый поток, но включение файлов PHP не является проблемой, специфичной для WP; так что если вы делаете открыть новую тему , я хотел бы призвать вас сделать это на переполнение стека.Основное правило: связан ли ваш код (т.е. упакован ) с кодом, обозначенным значком
@package
? Если нет, то вы используете неверное значение для@package
.Для большинства тем это легко:
@package: WordPress
и@subpackage Theme-Name
, потому что они упакованы и распространяются вместе с самим WordPress@package: Theme-Name
, потому что они упакованы и распространяются отдельно от WordPress.Все темы представляют собой абстракционный слой самого WordPress и полагаются на WordPress для вывода. Но эта зависимость не делает их
@subpackage
из WordPress.Я бы применил это правило и к темам для детей. Они представляют собой отдельный пакет, упакованный и распространяемый отдельно от родительской / шаблонной темы, на которую они полагаются.
источник
Это теги документации. Вы используете их для группировки связанных битов кода в целях документирования кода. В Википедии есть хороший график с различными доступными тегами. Официальная документация находится на http://www.phpdoc.org/ .
Правильно. Ничего не произошло. Это только для документации кода. Вы ничего не заметите, пока не запустите свой код через скрипт PHPDoc, который сгенерирует документацию, но не изменит работу вашего кода.
Используйте
@package
для определения вашей темы. Используйте@subpackage
, если хотите, чтобы сгруппировать функции внутри темы - скажем, файл, полный виджетов, специфичных для темы, или что-то еще.Какая разница, включая аннотацию @package или нет?
http://codex.wordpress.org/Inline_Documentation
источник
@package
Указать пакеты для групповых занятий или функции и определяет в, также темы для WordPress.@subpackage
Является ребенком темы, как функциональность для требования конкретного или темы ребенка, субпакета.Небольшая подсказка к документу о тегах phpdoc: http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.pkg.html
источник