WP_Image_Editor::generate_filename

Advertisement

Summery Summery

Builds an output filename based on current file, and adding proper suffix

Syntax Syntax

WP_Image_Editor::generate_filename( string $suffix = null, string $dest_path = null, string $extension = null )

Parameters Parameters

$suffix

(Optional)

Default value: null

$dest_path

(Optional)

Default value: null

$extension

(Optional)

Default value: null

Return Return

(string) filename

Source Source

File: wp-includes/class-wp-image-editor.php

	public function generate_filename( $suffix = null, $dest_path = null, $extension = null ) {
		// $suffix will be appended to the destination filename, just before the extension.
		if ( ! $suffix ) {
			$suffix = $this->get_suffix();
		}

		$dir = pathinfo( $this->file, PATHINFO_DIRNAME );
		$ext = pathinfo( $this->file, PATHINFO_EXTENSION );

		$name    = wp_basename( $this->file, ".$ext" );
		$new_ext = strtolower( $extension ? $extension : $ext );

		if ( ! is_null( $dest_path ) ) {
			$_dest_path = realpath( $dest_path );
			if ( $_dest_path ) {
				$dir = $_dest_path;
			}
		}

		return trailingslashit( $dir ) . "{$name}-{$suffix}.{$new_ext}";
	}

Advertisement

Changelog Changelog

Changelog
Version Description
3.5.0 Introduced.

Advertisement

Leave a Reply