PHPackages                             furbo/museum-plus-for-craft-cms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. furbo/museum-plus-for-craft-cms

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

furbo/museum-plus-for-craft-cms
===============================

Allows to import MuseumsPlus Collection data to Craft CMS and publish data.

1.0.4(1y ago)024proprietaryPHPPHP >=8.0.2

Since Jun 11Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/tonioseiler/museum-plus-for-craft-cms)[ Packagist](https://packagist.org/packages/furbo/museum-plus-for-craft-cms)[ RSS](/packages/furbo-museum-plus-for-craft-cms/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (41)Used By (0)

MuseumPlus for CraftCMS plugin for Craft CMS 4.x BRANCH craft-queue
===================================================================

[](#museumplus-for-craftcms-plugin-for-craft-cms-4x-branch-craft-queue)

Allows to import MuseumsPlus Collection data to Craft CMS and publish data.

[![Screenshot](resources/img/plugin-logo.png)](resources/img/plugin-logo.png)

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 4.7 or later and php 8.1 or later.

Installation
------------

[](#installation)

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

    ```
     cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
     composer require furbo/museum-plus-for-craft-cms

    ```
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for MuseumPlus for CraftCMS.

Overview
--------

[](#overview)

MuseumPlus for CraftCMS automatically imports items from one or more collections and makes them available to Craft.

### Features

[](#features)

- Import M+ Data From Craft
- Import Assets like mages or other files to a Craft File System
- Use Craft Transforms to generate thumnails etc
- Add additional fields to items
- Show item details or filtered lists (filter by vocabulary, people, ...)
- Include items in craft fulltext search
- Automatically enrich data from AI (Google Gemini).

Configuration
-------------

[](#configuration)

Once the plugin is installed, you can configure it in the Craft Control Panel under Settings → MuseumPlus for CraftCMS. You will need to provide:

- the MuseumPlus classifier
- the hostname for the MuseumPlus API
- the MuseumPlus API username
- the MuseumPlus API password

After saving the settings you will see the list of collections you have access to: choose at least one collection and save the settings. You should also choose the filesystem where the media will be stored: note that the two subfolders `Items` and `Multimedia` will be automatically created in the root of the filesystem. You can specify which kind of files to import: the plugin will download the files and store them in the chosen filesystem. In the settings there is a section to define the URI format and template to be used to show collection items in the frontend.

The shell command `./craft museum-plus-for-craft-cms/collection/update-items` will import the data from the selected collections. We advise to set up a cron job to run this command regularly.

Usage
-----

[](#usage)

In the backend you will see a new section called "Collection" where you can see the imported collections and their items

Frontend example to display the items:

```
{% set items = craft.museumPlus.items.all() %}
{% for item in items %}
    {{ item.title }}
    {{ item.description }}

{% endfor %}

```

Frontend example to display a list of items filtered by vocabuilary ref:

```
{% set vocabulary = craft.museumPlus.getVocabularyById(id) %}
{% set items = vocabulary.getItems() %}
{% for item in items %}
    {{ item.title }}
    {{ item.description }}

{% endfor %}

```

Frontend example to display a single item:

```
{% set item = craft.museumPlus.getItemById(id) %}
{% set attachment = item.getAttachment() %}
{% if attachment %}
    {% set myAssetUrl = attachment.getUrl() %}

{% endif %}
{{ item.title }}

```

Other methods available in twig:

```
craft.museumPlus.getItemById(id)
craft.museumPlus.getItemsByIds(ids)
craft.museumPlus.getVocabularies($type)
craft.museumPlus.getVocabularyById(id)
craft.museumPlus.getAllPeople()
craft.museumPlus.getPeopleById(id)
craft.museumPlus.getObjectGroupById(id)
craft.museumPlus.getAllObjectGroups()
craft.museumPlus.searchItems(params)

```

Methods available in on a item:

```
 - getAttachment // gets the main image / file
 - getMultimedia // gets other images / files
 - getObjectGroups // dito
 - getLiterature // dito
 - getOwnerships // dito
 - getAssociationPeople // dito
 - getOwnerPeople // dito
 - getAdministrationPeople // dito
 - getRelatedItems // gets the items related to this object
 - getVocabularyEntries // gets the vocabulary entries related to this item
 - getVocabularyEntriesByType(type) // gets the vocabulary entries related to this item filtered by type

```

Methods available in on a vocabulary entry:

```
 - getItems() // gets all ietms associted by this type
 - getParent() // get the parent vocabulary node
 - getParents() // get all parents up the tree
 - getPath() // get all parents up the tree plu sthe node itself

```

The getRecords methods gives acces to the underlying record element. Here the methods that can be called on the records (items, people, objectgroups, vocabulary entries, literature, ownerships)

```
 - getRepeatableGroupValues(groupName, attribute = null, filterTypes = [])
 - getDataAttributes() (for all)
 - getDataAttribute(name)

```

Get the items from objects like people, objectgroups, vocabulary entries, literature, ownerships

```
 - rec.getItems()

```

### Events

[](#events)

The plugin throws a custom event after an item has been updated or created by the plugin.Custom modules can then listen to the event and add some custom functionality.

Add this code to the init() method of your custom module in craft cms.

```
Event::on(
    MuseumPlusForCraftCms::class,
    MuseumPlusForCraftCms::EVENT_ITEM_UPDATED_FROM_MUSEUM_PLUS,
    function(ItemUpdatedFromMuseumPlusEvent $e) {
        //Example: lets say you have an extra field, for example is_new to show alle the newly created items in a collection.
        //The field can the be removed manually from the backend
        $item = $e->item;
        if ($e->isNewItem) {
          $item->is_new = true;
          Craft::$app->elements->saveElement($item);
        }
    }
);

```

Roadmap
-------

[](#roadmap)

- add geo refs via google to items

Brought to you by [Furbo GmbH](https://furbo.ch)

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance71

Regular maintenance activity

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 99.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~17 days

Recently: every ~28 days

Total

39

Last Release

41d ago

Major Versions

1.0.4 → 5.0.0-beta.12025-09-08

PHP version history (3 changes)1.0.0PHP >=8.0.2

5.0.0-beta.1PHP 8.2

5.0.0-beta.2PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/f92cc720a5ee612f170145b79f807c10f6b0d1fdf307228f8b93f9dfd3f75020?d=identicon)[tonioseiler](/maintainers/tonioseiler)

---

Top Contributors

[![tonioseiler](https://avatars.githubusercontent.com/u/4467443?v=4)](https://github.com/tonioseiler "tonioseiler (205 commits)")[![cmartinespinosa](https://avatars.githubusercontent.com/u/31882008?v=4)](https://github.com/cmartinespinosa "cmartinespinosa (1 commits)")

---

Tags

cmsCraftcraftcmscraft-pluginmuseumplus

### Embed Badge

![Health badge](/badges/furbo-museum-plus-for-craft-cms/health.svg)

```
[![Health](https://phpackages.com/badges/furbo-museum-plus-for-craft-cms/health.svg)](https://phpackages.com/packages/furbo-museum-plus-for-craft-cms)
```

###  Alternatives

[verbb/navigation

Create navigation menus for your site.

90683.7k17](/packages/verbb-navigation)[verbb/formie

The most user-friendly forms plugin for Craft.

101372.9k40](/packages/verbb-formie)[verbb/comments

Add comments to your site.

13753.1k](/packages/verbb-comments)[verbb/tablemaker

Create customizable and user-defined table fields.

40168.8k1](/packages/verbb-tablemaker)[supercool/tablemaker

Create customizable and user-defined table fields.

40141.7k](/packages/supercool-tablemaker)[pennebaker/craft-architect

CraftCMS plugin to generate content models from JSON/YAML data.

72148.5k5](/packages/pennebaker-craft-architect)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)