# TTT Crop

* Contributors: 33themes, gabrielperezs, lonchbox, tomasog, 11bits
* Tags: images, thumbnail, media editor, edit media, image sizes
* Requires at least: 3.7
* Tested up to: 4.7.3
* Stable tag: 1.0
* License: GPLv2 or later
* License URI: http://www.gnu.org/licenses/gpl-2.0.html 

Select any thumbnail size from your theme and crop it in a simple way.

## Description

This is an easy and fast way to crop any uploaded image in your wordpress. No more complicated graphical editors, photos of people without head or products with wrong view. Select a thumbnail, edit the crop area and save the new thumbnail image.

This plugin doesn't create any new file or folder, when it saves the new crop area it rewrites the original thumbnail file, this means it doesn't affect the theme design :)


## Available in WordPress.org

Yes, you can find it here:: https://wordpress.org/plugins/ttt-crop/

## Contribute

If you have any bug or code improvements, please send a pull request to: https://github.com/33themes/ttt-crop

## Features

* The plugin automatically use all images created with the function _add_image_size_ even if they are hard cropped or proportional. More info in http://codex.wordpress.org/Function_Reference/add_image_size#Crop_Mode
* "Crop Editor" quick link in media list.
* "Crop Editor" link in featured image widget.
* "Crop Editor" button inside file details in media manager.


## Screenshots and video


Video made by a happy user :)  
(https://software-lupe.de/review/ttt-crop-thumbnails-auf-mass/)

[![Nice video made by a happy user :)](https://img.youtube.com/vi/25dKFOV8toY/default.jpg)](https://www.youtube.com/watch?v=25dKFOV8toY)


Go to Media, open the image and click on Crop Editor.

![Edit image](/screenshots/screenshot-3.png)

Choose the image size you want and crop it.

![Save](/screenshots/screenshot-2.png)

![How it works](/screenshots/screenshot-1.png)

You also can crop from featured box

![Edit featured image](/screenshots/screenshot-4.png)

## Hacks

Just copy&paste this code into your functions.php.

**Remove sizes from the editor**

You can remove some sizes from the TTT Crop thumbnail editor with this code in your functions.php. 

Example code:

```php
    add_filter( 'tttcrop_image_sizes', 'custom_tttcrop_image_sizes');
    function custom_tttcrop_image_sizes( $sizes ) {
        unset( $sizes['thumbnail'] );
        unset( $sizes['large'] );
        return $sizes;
    }
```

**Set human friendly names for the thumbnails**

For example, the name "author-thumbnail" could be "Author Image" 


```php
    function local_ttt_crop_human_name($name) {
        switch( $name ) {
            case 'single-slider';
                return 'Home slider image'; break;
            case 'author-thumbnail';
                return 'Author Image'; break;

            default:
                return $name; break;
        }
    }
    add_filter('ttt_crop_human_name','local_ttt_crop_human_name');
```

**Show only some sizes of a post_type**

In this example you have the custom post type "author" and two image sizes
for the author content (single, archive, etc..). And you want to show only this
two image sizes on the crop screen. 

The idea is make it more simple for the end user, showing only
the sizes the user need.

```php
    add_action('init','custom_tttgallery_init',0);

    function custom_tttgallery_init() {
        global $pagenow;
        
        if ( 'admin-ajax.php' == $pagenow && $_REQUEST['action'] == 'ttt-crop_load' && isset($_REQUEST['post_id']) ) {
            if ( $post_type == 'author') {
                add_filter('tttcrop_image_sizes','custom_tttcrop_image_sizes_author');
            }
        }
    }

    function custom_tttcrop_image_sizes_author($sizes) {
        foreach ($sizes as $key => $values) {
            if ($key == 'author-thumbnail')
                $new[ $key ] = $values;
            elseif ($key == 'author-slider')
                $new[ $key ] = $values;
        }
        return $new;
    }
```


## Recomendations

If you are a developer and you need to rebuild the thumbnails we recommend use this plugin: http://wordpress.org/plugins/ajax-thumbnail-rebuild/ it helps you to do it one at a time. 

IMPORTANT: Notice that rebuilding thumbnails will overwrite the thumbnails cropped with the TTT Crop plugin.

## Installation

This section describes how to install the plugin and get it working.

1. Upload `ttt-crop` folder to the `/wp-content/plugins/` directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.