Документация для разработчиков WP Media Folder

Эта документация поможет опытным разработчикам интегрировать наш плагин с любыми другими сервисами. Здесь представлены все действия и фильтры для этого плагина; если вам потребуется что-то ещё, не стесняйтесь задавать вопросы на специальном форуме. Спасибо за использование нашего плагина!

Вспомогательный файл

WP Media Folder поставляется со вспомогательным файлом, содержащим основные функции, необходимые для его интеграции в ваши собственные темы и плагины.

Переместить файл в папку
Создать папки
Переместить папки
Сохранение вложений в папку
...

Например, вы можете создать новую папку следующим образом:

 include('wp-content/plugins/wp-media-folder/helper.php');
 \Joomunited\WPMediaFolder\Helper::createFolder('My new folder');

Крючки

import_term_meta

Запускается после импорта метаданных термина.

Параметры:

int $term_id ID of the newly created term.string $key Meta key.mixed $value Meta value.

Return :

void

В файлах:

файл class/import/class-wp-import.php строка 451

wpmf_after_replace

Выполните действия после замены файла

Параметры:

integer Attachment ID

Return :

void

В файлах:

файл class/class-replace-file.php, строка 462

wpmf_attachment_set_folder

Настройка папки для вложений после перемещения вложения в папку в менеджере медиафайлов. Этот хук также используется при импорте вложений в категории, после загрузки вложения и при назначении нескольких папок для вложения

Параметры:

integer Attachment IDinteger|array Target folder or array of target foldersarray Extra informations

Return :

void

В файлах:

class/class-wp-folder-option.php строка 457 class/class-wp-folder-option.php строка 3613 class/class-helper.php строка 140 class/class-helper.php строка 196 class/class-main.php строка 912 class/class-main.php строка 943 class/class-main.php строка 2831 class/class-main.php строка 3389 class/class-main.php строка 4616 class/class-main.php строка 5417

wpmf_before_delete_folder

Перед удалением папки

Параметры:

WP_Term Folder, this term is not available anymore as it as been deleted

Return :

void

В файлах:

class/class-main.php строка 4139 class/class-main.php строка 4516

wpmf_create_folder

Создание папки из медиатеки. Этот хук также используется при синхронизации и импорте файлов с FTP, создании папок на основе пользователей и ролей, а также импорте из Nextgen Gallery

Параметры:

integer Created folder IDstring Created folder nameinteger Parent folder IDarray Extra informations

Return :

void

В файлах:

class/class-wp-folder-option.php строка 3490 class/class-main.php строка 2808 class/class-main.php строка 3646 class/class-main.php строка 3660 class/class-main.php строка 3964

wpmf_delete_folder

Удалить папку

Параметры:

WP_Term Folder, this term is not available anymore as it as been deleted

Return :

void

В файлах:

class/class-main.php строка 4147 class/class-main.php строка 4525

wpmf_duplicate_attachment

Создать копию вложения

Параметры:

integer Attachment IDinteger Target folder

Return :

void

В файлах:

файл class/class-duplicate-file.php, строка 118

wpmf_move_folder

Перемещение папки из медиатеки. Этот хук также используется при изменении параметра папки роли

Параметры:

integer Folder moved IDstring Destination folder IDarray Extra informations

Return :

void

В файлах:

class/class-wp-folder-option.php строка 3005 class/class-main.php строка 4713

wpmf_update_folder_name

Обновить имя папки

Параметры:

integer Folder IDstring Updated name

Return :

void

В файлах:

class/class-folder-post-type.php строка 500 class/class-main.php строка 4078

wpmf_update_folder_name

Обновить имя папки

Параметры:

integer Folder IDstring Updated name

Return :

void

В файлах:

class/class-folder-post-type.php строка 500 class/class-main.php строка 4078

fallback_intermediate_image_sizes

Фильтрует размеры изображений, генерируемых для MIME-типов, отличных от изображений.

Параметры:

array $fallback_sizes An array of image size names.array $metadata Current attachment metadata.

Return :

void

В файлах:

файл class/class-helper.php, строка 312

import_term_meta_key

Фильтрует мета-ключ для импортированного фрагмента метаданных термина.

Параметры:

string $meta_key Meta key.int $term_id ID of the newly created term.array $term Term data from the WXR import.

Return :

void

В файлах:

файл class/import/class-wp-import.php, строка 432

wp_import_existing_post

Фильтруйте ID существующей записи, соответствующей импортируемой записи. Верните 0, чтобы принудительно импортировать запись. Фильтруйте ID по другому значению, чтобы определить, какая существующая запись сопоставляется с импортируемой.

Параметры:

int $post_exists Post ID, or 0 if post did not exist.array $post The post array to be inserted.

Return :

void

В файлах:

файл class/import/class-wp-import.php строка 505

wp_import_term_meta

Фильтрует метаданные, прикрепленные к импортированному термину.

Параметры:

array $termmeta Array of term meta.int $term_id ID of the newly created term.array $term Term data from the WXR import.

Return :

void

В файлах:

файл class/import/class-wp-import.php строка 416

wpmf_gallery_enable_download

Фильтр для включения/отключения загрузки изображений в галерее

Параметры:

boolean Enable/disable download image

Return :

boolean

В файлах:

файл class/class-display-gallery.php строка 473

wpmf_gallery_query_args

Для получения изображений используйте аргумент запроса Filter gallery.

Параметры:

array Gallery query arguments

Return :

array

В файлах:

файл class/class-display-gallery.php строка 411

wpmf_get_categories_args

Отфильтруйте по пользовательским параметрам, чтобы получить все категории

Параметры:

array Agument

Return :

array

В файлах:

файл class/class-main.php, строка 2263

wpmf_limit_folders

Фильтр для установки ограничения на количество загружаемых папок

Параметры:

integer Limit folder number

Return :

integer

В файлах:

class/class-folder-post-type.php строка 1769 class/class-main.php строка 1710

wpmf_limit_folders

Фильтр для установки ограничения на количество загружаемых папок

Параметры:

integer Limit folder number

Return :

integer

В файлах:

class/class-folder-post-type.php строка 1769 class/class-main.php строка 1710

wpmf_set_file_title

Перед сохранением в базу данных измените заголовок файла

Параметры:

string File title

Return :

string

В файлах:

файл class/class-main.php, строка 5538

wpmf_taxonomy_public

Фильтр для изменения публичного параметра таксономии wpmf-category

Параметры:

boolean Toxonomy public status

Return :

boolean

В файлах:

wp-media-folder.php строка 1570

wpmf_user_can

Фильтр проверяет возможность пользователя выполнить действие

Параметры:

boolean The current user has the given capabilitystring Action name

Return :

boolean

В файлах:

wp-media-folder.php строка 36 class/class-wp-folder-option.php строка 928 class/class-wp-folder-option.php строка 1135 class/class-wp-folder-option.php строка 1186 class/class-wp-folder-option.php строка 1478 class/class-wp-folder-option.php строка 1565 class/class-wp-folder-option.php строка 2204 class/class-wp-folder-option.php строка 3458 class/class-wp-folder-option.php строка 4161 class/class-wp-folder-option.php строка 4261 class/class-wp-folder-option.php строка 4329 class/class-wp-folder-option.php строка 4442 class/class-wp-folder-option.php строка 4493 class/class-wp-folder-option.php строка 4541 class/class-folder-access.php строка 41 class/class-duplicate-file.php строка 53 class/install-wizard/install-wizard.php строка 54 class/class-image-watermark.php строка 252 class/class-main.php строка 1133 class/class-main.php строка 1505 class/class-main.php строка 1544 class/class-main.php строка 1726 class/class-main.php строка 2685 class/class-main.php строка 2719 class/class-main.php строка 3521 class/class-main.php строка 3913 class/class-main.php строка 4025 class/class-main.php строка 4398 class/class-main.php строка 4450 class/class-main.php строка 4563 class/class-main.php строка 4659 class/class-main.php строка 4749 class/class-main.php строка 5031 class/class-main.php строка 5164 class/class-main.php строка 5355 class/class-main.php строка 5823 class/class-main.php строка 5870 class/pages/settings/image_compression.php строка 44 class/pages/settings/image_compression.php строка 98 class/pages/settings/image_compression.php строка 252 class/pages/settings/image_compression.php строка 288 class/pages/settings/import_export.php строка 159 class/pages/settings/import_export.php строка 332 class/class-replace-file.php строка 53 class/class-replace-file.php строка 509

Composer

Вот решение для использования наших плагинов в качестве зависимости Composer. Вам необходимо указать репозиторий Joomunited в файле composer.json. Пожалуйста, замените YOUR_TOKEN в URL-адресе на свой собственный токен. Вы можете найти его по адресу https://www.joomunited.com/my-account/my-membership в разделе «Токены Composer { "repositories":[ { "type":"package", "package":{ "name":"joomunited/wp-media-folder", "version":"master", "type":"wordpress-plugin", "dist":{ "type":"zip", "url":"https://www.joomunited.com/extra/download/wp-media-folder/YOUR_TOKEN", "reference":"master" } } } ], "require":{ "composer/installers":"~1.0", "joomunited/wp-media-folder":"dev-master" } }Обратите внимание, что команда `composer update` не работает с приватными репозиториями (для получения более подробной информации обратитесь к документации Composer ). Однако вы можете обновить плагин до последней версии вручную с помощью этой команды:composer remove joomunited/wp-media-folder && composer clearcache && composer require joomunited/wp-media-folder:dev-master

Программная настройка ключа обновления с помощью WP CLI

Используйте тот же ключ, который вы использовали при установке Composer, и выполните эту команду Composer, чтобы установить токен обновления. wp option update ju_user_token "YOUR_TOKEN"