6.0 Builtins

From Gramps
Revision as of 21:00, 13 September 2023 by Gioto (talk | contribs) (File:AvailableGrampsUpdatesforAddons-example-listing-52.png)
Gramps-notes.png
This page lists plug-ins packaged with each release of Gramps... the "built-ins".

There are also dozens of plug-ins that are Third-party Addons, written by users and developers to work only with Gramps version 5.2.

All plugins (whether built-in or add-on) can be enabled, hidden or disabled with the Plugin Manager.

Gramps comes with a core set of plugins which provide all of the critical features.

However, you can extend this functionality with additional Third-party Addons. These addons provide reports, filters, View modes, Gramplets, and more.

From Gramps [[Gramps_Template:Version manual_Wiki_Manual_-_Settings#General|Preferences]], you can check for available extra (or updated) addons and select which to download. Then, they will be retrieved from the internet from the Gramps-Project file server and installed locally on your computer.

Once installed, an addon is found in the same place as a built-in feature of the same Type. That is, Tool addons become new menu items on the Tools menu... while addon Gramplets become new choices in the appropriate Category View sidebar, bottombar or Dashboard options.

Installed addons can be enabled or disabled via the [[Gramps_Template:Version manual_Wiki_Manual_-_Plugin_Manager|Plugin Manager]].

Tango-Dialog-information.png
Can not find it?

The Plugin Manager and Preferences are good places to search when a feature is being elusive.

Addons are not typically cross-referenced in the wiki and might not be where you would expect in the interface.

What you recalled as a Report might actually be a Quick View... and those are found in entirely different menus. Or you might have installed an Addon for a different machine or in another version of Gramps.

So looking through the addons available for download and among those installed can help you rediscover the feature.


Installing Addons in Gramps

Highlighted section showing recommended settings for Addons to be managed Automatically

You can have Gramps manage the process of checking and downloading Addon updates by changing your settings to match the highlighted section in the screenshot to the right or read the following.

To configure Gramps for Addons:

  1. Start Gramps
  2. Select Menu Edit -> Preferences...
  3. Go to the General tab
  4. In the Third party addons management section:
  5. Change Check for addon updates: so when you start Gramps, it checks for updated Addons:
    1. Never - never checks for updates when you start Gramps (This is the default setting)
    2. Once a month - checks for updates when you start Gramps once a month
    3. Once a week - checks for updates when you start Gramps once a week (This is the recommended setting)
    4. Once a day - checks for updates when you start Gramps once a day
    5. Always - checks for updates whenever you start Gramps
  6. Change What to check so when you check for updates, it checks for:
    1. Updated addons only - does not check for new addons
    2. New addons only - does not check for updated addons (This is the default setting)
    3. New and updated addons - checks for all new and updated addons (This is the recommended setting)
  7. Verify that the Where to check has the correct URL. To locate the list of addons for your current language and version, it should be set to:
    https://raw.githubusercontent.com/gramps-project/addons/master/gramps60
  8. Change the Do not ask about previously notified addons check box:
    1. Checked: Means that new/updated addons are only asked about once; afterwards it doesn't show them to you (This is the default setting)
    2. Unchecked: Means that new/updated addons are always shown to you (This is the recommended setting)
  9. Assuming you have an Internet connection. You can now optionally select the Check for updated addons now button to force a check for Addons using the updated settings.
  10. From the Available Gramps Updates for Addons window you will be shown a list broken down by Type that you can view by selecting the "Select" column expand out each "Type".
  11. You can then select the check box of those Addons you want to install.
  12. Then select the Install Selected Addons button to download those Addons from the Internet.
  13. Once downloaded from the Done downloading and installing addons dialog select the Close button
  14. From the Preferences dialog select Close button.
  15. To use the Addons you need to Family Trees>Quit and restart Gramps.
"Available Gramps Updates for Addons" window showing example listing output for Gramps 5.2


Plugin List

Addons are listed inside of Gramps through the interface described above. The Plug-in Manager list includes the built-in Gramplets as well as any downloaded third party addons... such as those in the following list.

Tango-Dialog-information.png

for details of on each columns.


Plugin / Documentation Type Image Description Use Rating (out of 4) Contact Download
Legacy Citation Plugin to replicate Citations in Gramps v1.0 to v5.1

Addons for other versions of Gramps

Addons for other versions of Gramps can be found on the following pages

See also

Writing an Addon/Plugin