Change image name to wordpress post slug during upload

WordPress tutorial, Change image name to wordpress post slug during upload. If you want to rename files during upload and set their names to the post slug.

If you want to rename files during upload and set their names to the post slug the files are being attached to, plus some random characters (a simple incremental counter will be just fine) to make the filenames different.

Change image name to wordpress post slug during upload

In other words, if you are uploading/attaching images to the post whose page slug is “test-page-slug”, i’d like for the images to be renamed on the fly to test-page-slug-[C].[original_extension] — test-page-slug-1.jpg, test-page-slug-2.jpg etc (no matter what the original filenames were).

This is very easy. You just need to use following hook in functions.php file.

01function wp_modify_uploaded_file_names($image_name) {
02 
03    // Get the parent post ID, if there is one
04    if( isset($_GET['post_id']) ) {
05        $post_id = $_GET['post_id'];
06    } elseif( isset($_POST['post_id']) ) {
07        $post_id = $_POST['post_id'];
08    }
09 
10    // Only do this if we got the post ID--otherwise they're probably in
11    //  the media section rather than uploading an image from a post.
12    if(is_numeric($post_id)) {
13 
14        // Get the post slug
15        $post_obj = get_post($post_id);
16        $post_slug = $post_obj->post_name;
17 
18        // If we found a slug
19        if($post_slug) {
20 
21            $random_number = rand(10000,99999);
22            $image_name['name'] = $post_slug . '-' . $random_number . '.jpg';
23 
24        }
25 
26    }
27 
28    return $image_name;
29 
30}
31add_filter('wp_handle_upload_prefilter', 'wp_modify_uploaded_file_names', 1, 1);

This is very easy.
if you have pretty permalinks enabled, so I’ve added a check to make sure there is a slug before renaming the file. You’ll also want to consider checking the file type, which I haven’t done here–I’ve just assumed it’s a jpg.

Published by

Purab

I am Purab from India, Software development is my profession and teaching is my passion. Programmers blog dedicated to the JAVA, Python, PHP, DevOps and Opensource Frameworks. Purab's Github Repo Youtube Chanel Video Tutorials Connect to on LinkedIn View all posts by Purab

11 thoughts on “Change image name to wordpress post slug during upload”

very nice code trick..great.

thank youvery much

I googled for this many times till i finally found your page
Can you please tell me why im getting this error after modifying functions.php in /wp-includes/functions.php

Fatal error: Call to undefined function add_filter()

Thanks for this post, does exactly what I needed. How to check for file extension though?

Also how to automatically set the ‘Alt’ value on the image upload dialog to be the value of the Post title?

hi
its not worked for me?
whats wrong?

Purab Kharat says:

August 7, 2015 at 2:16 pm

did you added this code in functions.php file exactly as shown.

Reply

Hi,

Didn’t worked for me, i simply added this coded in my functions.php and its giving an error while image upload

Purab Kharat says:

August 12, 2015 at 6:51 pm

I will verify this..

Reply

Didn’t worked for me in 4.6.1 version

plz edit it i need

This is an excellent function Purab. However I added a few lines to dynamically get the file extension. I also didn’t use the random number, instead I took advantage of WP 4.x function that automatically increment and adds a numerical value to the filename if a similar name is detected.

$fileinfo = pathinfo( $image_name[‘name’] );
$fileext = empty( $fileinfo[‘extension’] ) ? ” : ‘.’ . $fileinfo[‘extension’];

$image_name[‘name’] = $post_slug . ‘-‘ . $fileext;

WP 4.6.1
PHP 5.6
MySQL 5.6