From f348f1dad53809bf8922f50d902a3c0f04b26383 Mon Sep 17 00:00:00 2001 From: Yog Date: Tue, 7 May 2024 14:53:16 +0200 Subject: [PATCH] Clean up unused old files --- test-theme.html | 922 ------------------------------------------------ tslint.json | 15 - 2 files changed, 937 deletions(-) delete mode 100644 test-theme.html delete mode 100644 tslint.json diff --git a/test-theme.html b/test-theme.html deleted file mode 100644 index f684b80..0000000 --- a/test-theme.html +++ /dev/null @@ -1,922 +0,0 @@ - - - - -WordPress Developer Resources - - - - - -
-
- -

This article is part of the WordPress.org - Code Reference. You can also open this article in your - browser.

-
-
- Browse: - Home / - Reference / - Functions / add_image_size() -
-
-
-

add_image_size( string $name, int $width, int $height, bool|array $crop = false )

-
-

Register a new image size.

-
-
- -
-

Contents

- -
-
-
-

Description Description

-

Cropping behavior for the image size is dependent on the value of $crop:

-
    -
  1. If false (default), images will be scaled, not cropped.
    2. -
  2. If an array in the form of array( x_crop_position, y_crop_position ): -
      -
    • x_crop_position accepts ‘left’ ‘center’, or ‘right’.
      • -
    • y_crop_position accepts ‘top’, ‘center’, or ‘bottom’. Images will be cropped to the specified - dimensions within the defined crop area.
      • -
    -
    3. -
  3. If true, images will be cropped to the specified dimensions using center positions.
    4. -
-
-
-
-

Parameters Parameters

-
-
$name
-
-

- (string) - (Required) - Image size identifier. -

-
-
$width
-
-

- (int) - (Optional) - Image width in pixels. Default 0. -

-
-
$height
-
-

- (int) - (Optional) - Image height in pixels. Default 0. -

-
-
$crop
-
-

- (bool|array) - (Optional) - Whether to crop images to specified width and height or resize. An - array can specify positioning of the crop area. -

-

Default value: false

-
-
-
-
-
-

Top ↑

-

Source Source -

-

- File: wp-includes/media.php -

- -
- 
function add_image_size( $name, $width = 0, $height = 0, $crop = false ) {
-	global $_wp_additional_image_sizes;
-
-	$_wp_additional_image_sizes[ $name ] = array(
-		'width'  => absint( $width ),
-		'height' => absint( $height ),
-		'crop'   => $crop,
-	);
-}
-
-
-

- - Expand full source code - Collapse full source code - - View on - Trac -

-
-
-
-

Top ↑

-

Changelog Changelog

- - - - - - - - - - - - - - -
Changelog
VersionDescription
2.9.0Introduced.
-
-
-
-

Top ↑

-

More Information More Information

-

Top ↑

-

Reserved Image Size Names Reserved Image Size Names -

-

‘thumb’, ‘thumbnail’, ‘medium’, ‘large’, ‘post-thumbnail’

-

The names “thumb” & “thumbnail” are just aliases- they are exactly the same.

-

For a detailed explanation and “why”, read further inside the image_downsize() - article.

-

However, if needed, you can always set the options yourself:

- 
update_option( 'thumbnail_size_w', 160 );
-update_option( 'thumbnail_size_h', 160 );
-update_option( 'thumbnail_crop', 1 );
-
-
-

Top ↑

-

Crop Mode Crop - Mode

-

Set the image size by resizing the image proportionally (without distorting it):

- 
add_image_size( 'custom-size', 220, 180 ); // 220 pixels wide by 180 pixels tall, soft proportional crop mode
-
-

Set the image size by cropping the image (not showing part of it):

- 
add_image_size( 'custom-size', 220, 180, true ); // 220 pixels wide by 180 pixels tall, hard crop mode
-
-

Set the image size by cropping the image and defining a crop position:

- 
add_image_size( 'custom-size', 220, 220, array( 'left', 'top' ) ); // Hard crop left top
-
-

When setting a crop position, the first value in the array is the x axis crop position, the - second is the y axis crop position.

-
    -
  • x_crop_position accepts ‘left’ ‘center’, or ‘right’.
    • -
  • y_crop_position accepts ‘top’, ‘center’, or ‘bottom’.
    • -
-

By default, these values default to ‘center’ when using hard crop mode.

-

You can find examples of the various crop types here.

-
-

Top ↑

-

Using the New Image Sizes Using the New Image Sizes -

-

Now that you’ve defined some custom image sizes, there are a variety of ways that you can use - them.
- For Featured Images

-

To use your custom image sizes for a post’s featured image, you can use the_post_thumbnail() - in the appropriate theme template file…

-

Note: To enable featured images the current theme must include add_theme_support( ‘post-thumbnails’ - ); in its functions.php file. See also Post Thumbnails.

- 
if ( has_post_thumbnail() ) {
-	the_post_thumbnail( 'your-custom-size' );
-}
-
-
-

Top ↑

-

For Media Library Images - (Admin) For Media Library Images (Admin)

-

You can also make your custom sizes selectable from your WordPress admin. To do so, you have to use - the image_size_names_choose hook to assign them a normal, human-readable name…

- 
add_filter( 'image_size_names_choose', 'my_custom_sizes' );
-
-function my_custom_sizes( $sizes ) {
-    return array_merge( $sizes, array(
-        'your-custom-size' => __( 'Your Custom Size Name' ),
-    ) );
-}
-
-
-

Top ↑

-

For General Media - (PHP/Templates) For General Media (PHP/Templates)

-

You can output images (by size) directly from the WordPress Media Library using PHP as well. To do - this, simply use wp_get_attachment_image(). -

- 
// Assuming your Media Library image has a post id of 42...
-echo wp_get_attachment_image( 42, 'your-custom-size' );
-
-

Note: If you just want the image URL instead of a pre-built tag, you can use wp_get_attachment_image_src() - instead.

-
-

Top ↑

-

Other Notes: Other Notes:

-

Using the ‘false’ setting will fail to produce a new image in the upload directory if one of the - image dimensions of the uploaded image are equal to the new image size.

-

If a registered image size is removed from functions.php, then any image uploaded before that point - and then deleted from the media library afterwards, does not have those auto-generated sizes deleted - too. Only image sizes that exist in functions.php are deleted.

-

Although height and width are not required parameters, their default values (0) will lead to unwanted - behavior, so bear in mind that you should always define them. As mentioned before, use a value of 9999 - to define the other dimension as the one to be considered when image resize is executed.

-
-
-
-

Top ↑

- -
-

Top ↑

-

Uses Uses -

- - - - - - - - - - - - - - - - -
Uses
UsesDescription
- wp-includes/functions.php: - absint() - -

Convert a value to non-negative integer.

-
-
- -
-
-
-

Top ↑

-

User Contributed Notes User Contributed Notes

-
-
    -
  1. -
    - Skip to - note 1 content -
    -
    You must log in to vote on the helpfulness of this - noteVote results for this note: 34You must log in to vote on the helpfulness of this - note
    -
    - - Contributed by Codex - - — - - - -
    -
    - -
    -

    In a theme’s functions.php file. Always use the “after_setup_theme” action - hook.

    - 
    add_action( 'after_setup_theme', 'wpdocs_theme_setup' );
-function wpdocs_theme_setup() {
-	add_image_size( 'category-thumb', 300 ); // 300 pixels wide (and unlimited height)
-	add_image_size( 'homepage-thumb', 220, 180, true ); // (cropped)
-}
-
    -
    - - -
    -
    2. -
  2. - -
    3. -
  3. -
    - Skip to - note 3 content -
    -
    You must log in to vote on the helpfulness of this - noteVote results for this note: 11You must log in to vote on the helpfulness of this - note
    -
    - - Contributed by rtpHarry - - — - - - -
    -
    - -
    -

    The section “Reserved Image Size Names” hints at it but doesn’t explicitly point out that - you can also customise the medium and large sizes via code by using these option names:

    -

    medium_size_h: The medium size height.
    - medium_size_w: The medium size width.
    - large_size_h: The large size height.
    - large_size_w: The large size width.

    -

    So for example, to set the large height to 700px you would use this code:

    - 
       update_option( 'large_size_h', 700 );
-
    -
    - - -
    -
    4. -
  4. - -
    5. -
  5. - -
    6. -
  6. -
    - Skip to - note 6 content -
    -
    You must log in to vote on the helpfulness of this - noteVote results for this note: 7You must log in to vote on the helpfulness of this - note
    -
    - - Contributed by pixeline - - — - - - -
    -
    - -
    -

    Note that along thumbnail, medium, large, there is - also a size built into wordpress that you can use : full to get the image at - its original dimensions.

    -
    - - -
    -
    7. -
  7. -
    - Skip to - note 7 content -
    -
    You must log in to vote on the helpfulness of this - noteVote results for this note: 2You must log in to vote on the helpfulness of this - note
    -
    - - Contributed by hongpong - - — - - - -
    -
    - -
    -

    If you upload an image whose dimensions match the add_image_size() when crop - is set to true, in the $meta object accessed by the - wp_generate_attachment_metadata filter, that matching image size will - not be available. Also, image sizes that have larger dimensions than an uploaded - photo will not be available either.

    -

    (Thus if you are using a technique to create something like a monochrome derivative image, - you won’t be able to get it to work if the uploaded image is exactly the same size as the - image size you’re using for your black and white version).

    -
    - - -
    -
    8. -
  8. -
    - Skip to - note 8 content -
    -
    You must log in to vote on the helpfulness of this - noteVote results for this note: 0You must log in to vote on the helpfulness of this - note
    -
    - - Contributed by likethegoddess - - — - - - -
    -
    - -
    -

    The cropping behavior cited as 2) in Description, https://developer.wordpress.org/reference/functions/add_image_size/#description, - is *not* currently supported. Please see the ticket at https://core.trac.wordpress.org/ticket/40370 - for more information.

    -
    - - -
    -
    9. -
-
-
-
-
-
-
-
-
- - \ No newline at end of file diff --git a/tslint.json b/tslint.json deleted file mode 100644 index 2bd680d..0000000 --- a/tslint.json +++ /dev/null @@ -1,15 +0,0 @@ -{ - "rules": { - "no-string-throw": true, - "no-unused-expression": true, - "no-duplicate-variable": true, - "curly": true, - "class-name": true, - "semicolon": [ - true, - "always" - ], - "triple-equals": true - }, - "defaultSeverity": "warning" -} \ No newline at end of file