plugin_name ); $acadpush_choice = isset( $acadpush_options['choice'] ) ? $acadpush_options['choice'] : 'community'; $acadpush_id_community_orcid = isset( $acadpush_options['id_community_orcid'] ) ? $acadpush_options['id_community_orcid'] : ''; $acadpush_access_token = isset( $acadpush_options['access_token'] ) ? $acadpush_options['access_token'] : ''; $acadpush_orcid_id = isset( $acadpush_options['orcid_id'] ) ? $acadpush_options['orcid_id'] : ''; $acadpush_extra_keyword = isset( $acadpush_options['extra_keyword'] ) ? $acadpush_options['extra_keyword'] : ''; $acadpush_number_publications = isset( $acadpush_options['number_publications'] ) ? $acadpush_options['number_publications'] : 10; $acadpush_filter_categories_raw = isset( $acadpush_options['filter_categories_raw'] ) ? $acadpush_options['filter_categories_raw'] : ''; // Design options $acadpush_primary_color = isset( $acadpush_options['primary_color'] ) ? $acadpush_options['primary_color'] : '#2271b1'; $acadpush_card_bg_color = isset( $acadpush_options['card_bg_color'] ) ? $acadpush_options['card_bg_color'] : '#ffffff'; $acadpush_card_border_color = isset( $acadpush_options['card_border_color'] ) ? $acadpush_options['card_border_color'] : '#dcdcde'; $acadpush_text_color = isset( $acadpush_options['text_color'] ) ? $acadpush_options['text_color'] : '#1d2327'; $acadpush_meta_text_color = isset( $acadpush_options['meta_text_color'] ) ? $acadpush_options['meta_text_color'] : '#646970'; $acadpush_font_family = isset( $acadpush_options['font_family'] ) ? $acadpush_options['font_family'] : 'system'; $acadpush_font_size = isset( $acadpush_options['font_size'] ) ? $acadpush_options['font_size'] : 'medium'; $acadpush_card_layout = isset( $acadpush_options['card_layout'] ) ? $acadpush_options['card_layout'] : 'standard'; $acadpush_border_radius = isset( $acadpush_options['border_radius'] ) ? $acadpush_options['border_radius'] : 'medium'; // Validate tab parameter against allowlist $acadpush_allowed_tabs = array( 'api', 'design', 'usage' ); $acadpush_raw_tab = isset( $_GET['tab'] ) ? sanitize_text_field( wp_unslash( $_GET['tab'] ) ) : 'api'; // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only tab navigation, no state change $acadpush_active_tab = in_array( $acadpush_raw_tab, $acadpush_allowed_tabs, true ) ? $acadpush_raw_tab : 'api'; ?>

API Settings Design Usage

plugin_name ); do_settings_sections( $this->plugin_name ); ?>

Zenodo API Configuration

Choose whether to display publications from a Zenodo community or an ORCID author profile.
Community: Enter community ID (e.g., digiwell) - see https://zenodo.org/communities/digiwell
ORCID: Enter ORCID identifier (e.g., 0000-0002-1276-2702)
Recommended for accessing full publication data. Get your token at: Zenodo → Account → Applications → Personal access tokens
Filter publications by Zenodo keyword/tag. Leave empty to show all publications.
Number of publications to display per page (default: 10, Zenodo API max: 100).
plugin_name ); do_settings_sections( $this->plugin_name ); ?>

Color Scheme

Used for links and accent elements.
Used for dates, authors, and secondary information.

Typography & Layout

Basic Shortcode

Add this shortcode to any page or post to display your Zenodo publications:

[showcase-publications]

This will display all publications from your configured Community or ORCID.

Available Parameters

Parameter Description Example Values
keyword Filter publications by Zenodo keyword/tag. Overrides the "Extra keyword" setting in API Settings tab. 'DMP', 'research', '2024'
type Filter by general resource type (publication, dataset, software, etc.) 'publication', 'dataset', 'software'
subtype Filter by publication subtype (article, book, thesis, etc.). Only works when type='publication'. 'article', 'conferencepaper', 'thesis'
lang Set the display language for labels and date formatting. 'en' (English), 'cs' (Czech)

Examples

Example 1: Display all publications in English

[showcase-publications lang='en']

Example 2: Filter by keyword "DMP"

[showcase-publications keyword='DMP']

Shows only publications tagged with "DMP" in Zenodo.

Example 3: Filter by publication type

[showcase-publications type='publication' subtype='article']

Display only journal articles.

Example 4: Show only datasets

[showcase-publications type='dataset']

Display only datasets (no subtype needed).

Example 5: Combine keyword and type filters

[showcase-publications type='publication' subtype='conferencepaper' keyword='AI']

Display only conference papers about AI.

Example 6: Multiple pages with different filters

You can use different keywords on different pages of your site:

  • Publications page: [showcase-publications]
  • Projects page: [showcase-publications keyword='projects']
  • Datasets page: [showcase-publications keyword='dataset']

Tips

  • Make sure to configure your Community ID or ORCID in the API Settings tab first.
  • Adding a Zenodo Access Token is recommended for accessing full publication metadata.
  • Use the Design tab to customize colors and layout to match your site's theme.
  • Test your shortcode on a draft page before publishing.
  • Publications are cached for 1 hour to improve performance.