原文:http://www.solagirl.net/customize-wordpress-media-upload-ui.html
WordPress编写文章界面的添加媒体按钮允许用户上传多媒体文件,但并不是每个人都能用的顺手,有的人倾向于引用外部图片,所以希望“从URL上传”这一项是默认选中的,有的人喜欢从媒体库中挑选图片,如果定制一下WordPress添加媒体界面,就能称心如意了。
注:该代码只适用于<3.5的版本,3.5以上定制方法请看文章最后一节。
WordPress的好处就是提供了很多钩子函数(actions and filters),使用户不用更改核心文件就能改变很多WordPress的默认行为,媒体界面也不例外。
更改多媒体选项卡位置
多媒体选型卡通常有四项:从计算机上传、从URL上传、从相册上传(如果该文章已经有图片附件)和从媒体库选择图片。
改变它们的顺序只需要使用filter: media_upload_tabs。将下面的代码放到主题的functions.php中即可看到效果
这段代码会使“从URL”变成第一项,改变返回的数组的元素顺序,即可改变多媒体选项卡的顺序
add_filter('media_upload_tabs', 'modify_media_tabs');
function modify_media_tabs($tabs) {
return array(
'type_url' => __('From URL'),
'type' => __('From Computer'),
'gallery' => __('Gallery'),
'library' => __('Media Library')
);
}
设置默认选项卡
前面提到有人喜欢直接通过URL插入图片,那么就让“从URL”变成默认选中的选项卡吧,将下面代码放到主题的functions.php中查看效果
add_filter('_upload_iframe_src', 'change_default_media_tab');
function change_default_media_tab($uri) {
return $uri.'&tab=type_url';
}
要默认选中其它选项卡,只需要更改tab后面的值:
从媒体库 – tab=library
从相册 – tab=gallery
从计算机 – tab=type
删除某个选项卡
将下面的代码放到主题的functions.php中
add_filter('media_upload_tabs', 'remove_media_library_tab');
function remove_media_library_tab($tabs) {
unset($tabs['library']);
//unset($tabs['type_url']); //删除从URL
//unset($tabs['gallery']); //删除从相册
//unset($tabs['type']); //删除从计算机 return $tabs;
}
媒体库选项卡将被删除
添加自定义消息
add_action( 'post-upload-ui', 'media_upload_infobox' );
add_action('pre-html-upload-ui','media_std_upload_infobox'); function media_upload_infobox() {
?>
<div style="background:#FFCC66; color:#000000; padding:10px; text-align:center">
自定义消息
</div> <?php
} function media_std_upload_infobox() {
?>
<div style="background:#FFCC66; color:#000000; padding:10px; text-align:center">
使用标准上传工具上传界面的自定义消息
</div> <?php
}
效果如下
WordPress 3.5.0以上版本的定制方法
3.5以上media_upload_tabs这个钩子虽然存在但已经没有任何用处,3.5以上可以用media_view_strings这个filter来修改界面。下面的代码演示如何删除Create Gallery和Set Featured Image。
add_filter('media_view_strings', 'remove_media_library_tabs');
function remove_media_library_tabs( $strings ) { $strings["insertMediaTitle"] = "插入图片";
$strings["insertIntoPost"] = "点击插入";
$strings["addMedia"] = "添加图片";
$strings["returnToLibrary"] = "回到已上传"; $strings["mediaLibraryTitle"] = "已上传"; //创建相册
unset( $strings["createNewGallery"]);
$strings["createGalleryTitle"] = ""; //创建新的播放列表
unset( $strings["createNewPlaylist"]);
$strings["createPlaylistTitle"] = ""; //创建音频播放列表
unset( $strings["createNewPlaylist"] );
$strings["createPlaylistTitle"] = ""; //创建视频播放列表
unset( $strings["createNewVideoPlaylist"] );
$strings["createVideoPlaylistTitle"] = ""; //特色图片
unset( $strings["setFeaturedImageTitle"] ); return $strings;
}
可以unset的字符串变量如下
Array
(
[url] => URL
[addMedia] => Add Media
<a href="http://www.solagirl.net/?s="></a> => Search
[select] => Select
[cancel] => Cancel
[selected] => %d selected
[dragInfo] => Drag and drop to reorder images.
[uploadFilesTitle] => Upload Files
[uploadImagesTitle] => Upload Images
[mediaLibraryTitle] => Media Library
[insertMediaTitle] => Insert Media
[createNewGallery] => Create a new gallery
[returnToLibrary] => ← Return to library
[allMediaItems] => All media items
[noItemsFound] => No items found.
[insertIntoPost] => Insert into post
[uploadedToThisPost] => Uploaded to this post
[warnDelete] => You are about to permanently delete this item.
'Cancel' to stop, 'OK' to delete.
[insertFromUrlTitle] => Insert from URL
[setFeaturedImageTitle] => Set Featured Image
[setFeaturedImage] => Set featured image
[createGalleryTitle] => Create Gallery
[editGalleryTitle] => Edit Gallery
[cancelGalleryTitle] => ← Cancel Gallery
[insertGallery] => Insert gallery
[updateGallery] => Update gallery
[addToGallery] => Add to gallery
[addToGalleryTitle] => Add to Gallery
[reverseOrder] => Reverse order
)