Media library management in Wordpress - Mini Project: Build & Apply

Media library management

📖 Scenario: You are building a simple WordPress plugin to manage a media library. This plugin will help organize media files by categories and display them on a page.

🎯 Goal: Create a WordPress plugin that registers a custom taxonomy for media categories, assigns categories to media items, and displays media items filtered by category on a page.

📋 What You'll Learn

Register a custom taxonomy called media_category for attachments

Assign media items to categories using the taxonomy

Create a shortcode [media_library] to display media items filtered by a category

Use WordPress functions and hooks properly

💡 Why This Matters

🌍 Real World

Managing and organizing media files in WordPress sites is common for photographers, bloggers, and businesses. Custom taxonomies help categorize media for easier searching and display.

💼 Career

WordPress developers often create plugins or themes that extend media management. Understanding taxonomies, shortcodes, and WP_Query is essential for customizing WordPress sites.

1

Register custom taxonomy for media categories

Write code to register a custom taxonomy called media_category for the attachment post type using the register_taxonomy function inside the init action hook.

Wordpress

<?php
// Register custom taxonomy for media categories
// Your code here

Need a hint?

Use add_action('init', function() { ... }); and inside it call register_taxonomy with 'media_category' and 'attachment'.

2

Add shortcode to display media by category

Create a shortcode media_library using add_shortcode that accepts an attribute category. Store the attribute in a variable called $category.

Wordpress

 'Media Categories',
        'hierarchical' => true,
        'show_ui' => true,
        'show_admin_column' => true,
        'rewrite' => ['slug' => 'media-category'],
    ]);
});

// Add shortcode to display media by category
// Your code here

Need a hint?

Use add_shortcode('media_library', function($atts) { ... }); and inside assign $category = $atts['category'];.

3

Query media items filtered by category

Inside the shortcode callback, write a WP_Query to get attachments filtered by the media_category taxonomy term matching $category. Store the query in a variable called $query.

Wordpress

 'Media Categories',
        'hierarchical' => true,
        'show_ui' => true,
        'show_admin_column' => true,
        'rewrite' => ['slug' => 'media-category'],
    ]);
});

add_shortcode('media_library', function($atts) {
    $atts = shortcode_atts(['category' => ''], $atts, 'media_library');
    $category = $atts['category'];

    // Query media items filtered by category
    // Your code here
});

Need a hint?

Use new WP_Query with post_type set to attachment and a tax_query filtering media_category by $category.

4

Display media items in shortcode output

Complete the shortcode callback by looping through $query->posts and building an HTML string with wp_get_attachment_image for each media item. Return the HTML string at the end.

Wordpress

 'Media Categories',
        'hierarchical' => true,
        'show_ui' => true,
        'show_admin_column' => true,
        'rewrite' => ['slug' => 'media-category'],
    ]);
});

add_shortcode('media_library', function($atts) {
    $atts = shortcode_atts(['category' => ''], $atts, 'media_library');
    $category = $atts['category'];

    $query = new WP_Query([
        'post_type' => 'attachment',
        'tax_query' => [[
            'taxonomy' => 'media_category',
            'field' => 'slug',
            'terms' => $category,
        ]],
        'posts_per_page' => -1,
    ]);

    // Loop through media items and build HTML
    // Your code here
});

Need a hint?

Loop through $query->posts with foreach, append images to a string, and return it.