Перейти к основному содержанию

Документация для разработчиков 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-main.php строка 912class/class-main.php строка 943class/class-main.php строка 2833class/class-main.php строка 3391class/class-main.php строка 4618class/class-main.php строка 5421class/class-helper.php строка 2599class/class-helper.php строка 2655class/class-wp-folder-option.php строка 457class/class-wp-folder-option.php строка 3645

wpmf_before_delete_folder

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

Параметры:

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

Return :

void

В файлах:

class/class-main.php строка 4141class/class-main.php строка 4518

wpmf_create_folder

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

Параметры:

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

Return :

void

В файлах:

class/class-main.php строка 2810class/class-main.php строка 3648class/class-main.php строка 3662class/class-main.php строка 3966class/class-wp-folder-option.php строка 3522

wpmf_delete_folder

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

Параметры:

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

Return :

void

В файлах:

class/class-main.php строка 4149class/class-main.php строка 4527

wpmf_duplicate_attachment

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

Параметры:

integer Attachment IDinteger Target folder

Return :

void

В файлах:

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

wpmf_move_folder

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

Параметры:

integer Folder moved IDstring Destination folder IDarray Extra informations

Return :

void

В файлах:

class/class-main.php строка 4715class/class-wp-folder-option.php строка 3021

wpmf_update_folder_name

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

Параметры:

integer Folder IDstring Updated name

Return :

void

В файлах:

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

wpmf_update_folder_name

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

Параметры:

integer Folder IDstring Updated name

Return :

void

В файлах:

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

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, строка 2771

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, строка 2265

wpmf_limit_folders

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

Параметры:

integer Limit folder number

Return :

integer

В файлах:

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

wpmf_limit_folders

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

Параметры:

integer Limit folder number

Return :

integer

В файлах:

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

wpmf_set_file_title

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

Параметры:

string File title

Return :

string

В файлах:

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

wpmf_taxonomy_public

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

Параметры:

boolean Toxonomy public status

Return :

boolean

В файлах:

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

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"