后台设置页面使用WordPress媒体上传工具上传图片

WordPress 的媒体上传工具有着良好的用户体验,即时从来没有接触过 WordPress 的新手,使用一两遍之后也会很快上手。开发 WordPress 设置页面的时候,如果我们需要用户上传图片,直接调用 WordPress 的媒体上传工具是一个非常好的选择。

在本文中,我们将通过简单的几段示例代码,为大家介绍怎么在 WordPress 的设置页面调用 WordPress 的媒体上传工具来实现上传字段。

1、实现需要的 Javascript 代码

首先,我们需要在主题插件文件夹中创建一个 JavaScript 文件(如:media-uploader.js),该文件中包含如下代码。

  1. jQuery(document).ready(function($){
  2. var mediaUploader;
  3. $('#upload_image_button').click(function(e) {
  4. e.preventDefault();
  5. if (mediaUploader) {
  6. mediaUploader.open();
  7. return;
  8. }
  9. mediaUploader = wp.media.frames.file_frame = wp.media({
  10. title: 'Choose Image',
  11. button: {
  12. text: 'Choose Image'
  13. }, multiple: false });
  14. mediaUploader.on('select', function() {
  15. var attachment = mediaUploader.state().get('selection').first().toJSON();
  16. // 插入媒体URL到背景图像字段中
  17. $('#background_image').val(attachment.url);
  18. });
  19. mediaUploader.open();
  20. });
  21. });

上面代码所做的工作很简单,当我们点击 #upload_image_button 按钮时,代码调用 WordPress 的媒体上传工具,用户选择图片后,插入图片网址到 #background_image 字段,作为该字段的值。

创建并保存好上面的代码文件后,下一步,我们需要把这个 JavaScript 文件加载到页面中。

  1. add_action('admin_enqueue_scripts', function () {
  2. wp_enqueue_media();
  3. wp_register_script('media-uploader', plugins_url('media-uploader.js', __FILE__ ), array('jquery'));
  4. wp_enqueue_script('media-uploader');
  5. });

需要注意的是,因为本示例中,我们开发的是后台页面,需要使用 admin_enqueue_scripts 钩子来加载 JavaScript 文件,如果是前端页面,我们需要使用 wp_enqueue_scripts 钩子。

2、实现表单字段

实现了上传的 JavaScript 功能后,下一步,我们需要在对应的位置插入包含对应 ID 的表单字段。

  1. <input id="background_image" type="text" name="background_image" value="<?php echo get_option('background_image'); ?>" />
  2. <input id="upload_image_button" type="button" class="button-primary" value="Insert Image" />

上面代码实现的表单字段大致如下图所示,点击「Insert Image」按钮,我们就可以调起 WordPress 的媒体上传工具,上传或选择已经上传的图片,然后,插图该图片到前面的 URL 字段中。
后台设置页面使用WordPress媒体上传工具上传图片
如果需要更加良好的用户体验,我们还可以简单调整一下上面的代码,比如,添加一个隐藏的字段用于保存媒体的 ID、添加一个预览字段用于显示缩略图等等。篇幅所限,就不再这里细说了,有需要的朋友可以自行实现。

给TA打赏
共{{data.count}}人
人已打赏
WordPress教程

WooCommerce 获取用户总消费金额

2022-4-13 1:58:07

WordPress教程

WP User Manager 添加自定义页面到我的账户页面和个人资料页面

2022-4-13 5:03:20

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索