How can you change the 'Insert into Post' title in the media button?

Question

Actualy the question says it all. I integrated a media upload box to my admin page and a button with the text 'Insert into post' makes no sense. I rather like to change it to something like 'Use this image'. Anyone got a clue on how you are able to do so?

Answer 1

add_filter("attribute_escape", "myfunction", 10, 2);
function myfunction($safe_text, $text) {
    return str_replace("Insert into Post", "Use this image", $text);
}

Place in your theme functions file of in a plugin file.

The first usable filter that this button hits is on the function esc_attr(). So what that code will do is find any instance of Insert into Post that is run through esc_attr() and replace it to Use this image. This code might have undesired issues elsewhere though. Maybe there is a language file method someone might know of that might be a better solution than this.

TRY:

add_filter("attribute_escape", "myfunction", 10, 2);
function myfunction($safe_text, $text) {
    return str_replace(__('Insert into Post'), __('Use this image'), $text);
}

Should account for translations.

Answer 2

With WordPress 3.5+ Media Uploader, there's another way. All strings are localized at the bottom of the page with:

<script type='text/javascript'>
/* <![CDATA[ */
var _wpMediaViewsL10n = {
    "url":"URL",
    "addMedia":"Add Media",
    "search":"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":"\u2190 Return to library",
    "allMediaItems":"All media items",
    "noItemsFound":"No items found.",
    "insertIntoPost":"Insert into post",
    "uploadedToThisPost":"Uploaded to this post",
    // ET CETERA
    };
/* ]]> */
</script>

On document.ready, we modify the object:

add_action('admin_footer', function()
{
    ?>
    <script type="text/javascript">
        // or without jQuery: http://stackoverflow.com/q/799981
        jQuery(document).ready( function($) {
            _wpMediaViewsL10n.insertIntoPost = 'Gotchya!';
        });
    </script>
    <?php
});

Answer 3

Filter 'gettext', take care to catch the target string only by checking the text domain. See this answer for a rather verbose example.

A simplified way:

add_filter( 'gettext', 'wpse_41767_change_image_button', 10, 3 );

function wpse_41767_change_image_button( $translation, $text, $domain )
{
    if ( 'default' == $domain and 'Insert into Post' == $text )
    {
        // Once is enough.
        remove_filter( 'gettext', 'wpse_41767_change_image_button' );
        return 'Use this image';
    }
    return $translation;
}

This is the only way to avoid false positives. A plugin author may use the same string in another location, so you have to verify the text domain.

Answer 4

WARNING: using the hook "attribute_escape" is kinda bad. This function is called for ALL text including post titles and content. Using this filter as stated in the accepted answer breaks html entity encoding.

For instance the title Features & Pricing appears as Features & Pricing in the title field. After saving it then shows Features & Pricing. After saving again you get Features & Pricing.

A better alternative might be to use jquery to change the button text.

add_action( 'admin_head', 'admin_head_script' );
function admin_head_script()
{
?>
<script>
    jQuery(document).ready(function($){
        $('input[value="Insert into Post"]').val('Use this Image');
    });
</script>
<?php
}

Answer 5

or via CSS

.your-media-frame .media-button-insert{
    font-size:0px;
}
.your-media-frame .media-button-insert:before{
    content:'Insert image';
    font-size:14px;
}

Answer 6

The gettext filter enables you to modify text elements on your WordPress site.

add_filter( 'gettext', 'change_button_text');

function change_button_text( $text ) {
    return str_ireplace( 'Insert into post',  'Use',  $text );
}