Fetch collections with counts for navigation menus

Retrieves all collections for an artist with artwork counts. Use this to populate collection navigation menus, display collection cards on profile pages, or filter artworks by collection.

Results are ordered by most recent artwork upload (newest first), making active collections appear at the top. Empty collections appear last.

For visibility-filtered collections (respecting privacy settings), combine with get_collect_visibility() from the settings module.

Usage

get_artist_collections_summary(artist, cn = NULL)

Arguments

artist

Character. Artist UUID (format: "746bxxxx-xxxx-xxxx-xxxxxxxxxxxx"). Validated with artcore::validate_uuid() where applicable.

cn

Database connection. If NULL, creates a connection via artcore::dbc() and closes it on exit. Pass an existing connection to batch multiple queries efficiently.

Value

data.table with columns:

collection_uuid

Collection identifier

collection_name

Display name

artist_uuid

Owner's artist UUID

artwork_count

Number of artworks in collection

last_artwork_date

Timestamp of most recent artwork

See also

Other data-access: art_has_nft(), db-frame-analytics, get_art_opensea_url(), get_art_print_url(), get_art_purchase_urls(), get_artist_by_slug(), get_artist_index(), get_artist_opensea(), get_artist_recent_works(), get_artist_stats(), get_artist_style_map(), get_artist_tags(), get_artwork_index(), get_artwork_meta(), get_artwork_opensea(), get_artwork_profile(), get_artwork_profile_full(), get_artwork_stats(), get_color_codes(), get_verification_info()

Examples

if (FALSE) { # \dontrun{
collections <- get_artist_collections_summary(artist)
# Show non-empty collections first
collections[artwork_count > 0]
} # }