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_uuid, cn = NULL)

Arguments

artist_uuid

Artist UUID (validated with artcore::validate_uuid)

cn

Optional database connection. Pass an existing connection to avoid connection overhead when making multiple queries.

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: artHasNFT(), db-frame-analytics, getArtistOpensea(), getArtistStyleMap(), getArtworkIndex(), getArtworkMeta(), getArtworkOpensea(), getArtworkProfile(), getArtworkProfileFull(), getArtworkStats(), getImageRaster(), getVerificationInfo(), get_artist_by_slug(), get_artist_recent_works(), get_artist_stats()

Examples

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