Super-Swank Featured Image

A WordPress plugin that sets a default featured image for posts, pages, and custom post types when no featured image is set.

Description

Super-Swank Featured Image allows you to set a default featured image that will be used when no featured image is manually set for a post, page, or custom post type. This ensures your content always has a consistent look, even when authors forget to set a featured image.

Features

• Set a default featured image for all content types
• Support for both classic and block editor
• Customizable crop positions for each social media platform
• Image cropping functionality with customizable aspect ratio
• Responsive admin interface
• Translation-ready

Requirements

• WordPress 5.9 or higher
• PHP 8.2 or higher

Installation

1. Download the plugin zip file
2. Go to WordPress admin panel > Plugins > Add New
3. Click "Upload Plugin"
4. Upload the zip file
5. Activate the plugin

Configuration

1. Go to Settings > Default Featured Image
2. Click "Select Image" to choose your default featured image
3. For each social media platform (Facebook/LinkedIn, Twitter, Instagram, Pinterest):
   • Choose the horizontal crop position (Left, Center, Right)
   • Choose the vertical crop position (Top, Center, Bottom)
4. Save changes

The plugin will automatically generate appropriately cropped versions of your image for each social media platform based on your selected crop positions. When you change a crop position, all affected images will be automatically regenerated with the new crop settings.

Image Dimensions

The plugin generates images in the following dimensions:

• Facebook/LinkedIn: 1200×630 pixels
• Twitter: 1200×600 pixels
• Instagram: 1080×1080 pixels
• Pinterest: 1000×1500 pixels

Crop Positions

For each social media platform, you can choose:

Horizontal Position:

• Left: Crops from the left edge
• Center: Crops from the horizontal center (default)
• Right: Crops from the right edge

Vertical Position:

• Top: Crops from the top edge
• Center: Crops from the vertical center (default)
• Bottom: Crops from the bottom edge

This is particularly useful when your original image has different aspect ratios than the social media platforms require, allowing you to control which part of the image is preserved during cropping.

Usage

Once configured, the plugin will automatically use your selected default image as the featured image for any post, page, or custom post type that doesn't have a featured image set.

Filters

The plugin provides several filters to customize its behavior:

// Customize the crop aspect ratio (default 16:9)
add_filter('ssfi_crop_aspect_ratio', function() {
    return 4/3; // Change to desired aspect ratio
});

// Customize minimum crop dimensions
add_filter('ssfi_crop_min_width', function() {
    return 300; // Change minimum width in pixels
});

add_filter('ssfi_crop_min_height', function() {
    return 300; // Change minimum height in pixels
});

Development

Prerequisites

• PHP 8.2 or higher
• WordPress 5.9 or higher
• Composer (for development)

Setup for Development

1. Clone this repository
2. Run composer install to install development dependencies

Building Assets

The plugin uses vanilla JavaScript and CSS, so no build process is required.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the GPL v3 License - see the LICENSE file for details.