Changes

{{#vardefine:chapter|910}}

[[Image:GrampletsDefault-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramplets Dashboard Category (Default View)]]

A Gramps Gramplet is a view of data that either changes dynamically during the running of Gramps, or provides interactivity to your genealogical data. Gramplets are the [http://en.wikipedia.org/wiki/Widget_engine widgets] that are part of Gramps and can be seen in the [[Gramps_4.0_Wiki_Manual_-_Main_Window_Categories#Gramplets_CategoryDashboard_Category|Gramplets Dashboard Category]], [[#Sidebar_and_bottombarGramplets_available_in_the_Sidebar_and_bottombar_of_other_Categories|Sidebars and Bottombars]] in other Navigator Categories, they provide all kinds of functionality that can be useful for the researcher.

== General Usage and Configuration == [[Image:GrampletDetached-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Detached Gramplets View]] You can drag the Properties button (top left) of each Gramplet to move it around the Dashboard View area. You can click the Properties button to detach the Gramplet from Dashboard View and place it in its own window. The window will stay open regardless of page (relationship, ancestry, etc). Closing the detached view will put it back onto the Dashboard view. If you quit Gramps with a open gramplet, when you start gramps again, it will open automatically.

When you first start one or more Gramplets are undocked from the Gramplets Category Dashboard View, you will see two default Gramplets; the '''Welcome can change to Gramps a different view (Messagesuch as the People or Charts Views) Gramplet''' . In this way, you can use these gramplets to supplement a particular view with additional details and functionality provided by the '''Top Surnames Gramplet'''gramplet.

{{-}}You can add new gramplets by right clicking on an open space on Dashboard view.  You can also change the number of columns by changing a setting in ''configure the active view'' to open the ''Configure Gramplets'' window, to change the Dashboard Layouts > Number of Columns.

[[Image:GrampletDetachedIf a link in a Gramplet is to a specific person, then clicking the link will change the Active Person. Double-40clicking such any link to a specific Gramps item (such as person or family) will bring up the Editor for that item.png|To edit a linked person without changing the Active Person, right|thumb|400px|Fig-click on the person link. {{#var:chapter}}Depending on the type of entry, double-clicking any row in a Quick View table will either select more specific data (drill down) or bring up the editor.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Detached Gramplets View]]

You can drag Double-clicking the Properties button (top left) title of each Gramplet to move it around a gramplet docked in the Gramplet View area. You can click the Properties button Dashboard Category allows you to detach the Gramplet from Gramplet View and place it in its own window. The window will stay open regardless of page (relationship, ancestry, etc). Closing the detached view will put it back onto change the Gramplets view. If you quit Gramps with a open gramplet, when you start gramps again, it will open automaticallydisplay title.

When one or {{man note|Want Additional Gramplets|To get more Gramplets are undocked from use the Gramplet View, you can change [[Gramps_4.0_Wiki_Manual_-_Plugin_Manager|'''Plugin Manager''']] to a different view (such as the People or Ancestry Views)get additional [[4. In this way, 0_Addons|'''Addons''']] for you can use these gramplets to supplement a particular view with additional details and functionality provided by . Check the list of the grampletavailable reports [[4.0_Addons|'''here''']].}}

You can add new == Summary of gramplets by right clicking on an open space on Gramplets. You can also change the number of columns by right-clicking an open area on the Gramplets page.==

[[Image:Default.gramplets.gramps.bar.relationships.and.charts.views.png|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Default gramplets available from the Gramps bar (side & bottom) Sidebar and Bottombar on the Relationships View Category and Charts ViewsCategory]][[Image:Default-gramplets.png|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Default gramplets available on Gramplets ViewDashboard Category]]

These are 18 26 default gramplets:

# Age Stats Gramplet - see view age span graphs

# Given Name Cloud Gramplet - most popular given namesas a "text cloud"# Import Gramplet# Latest Changes Gramplet# Pedigree Gramplet - see a complete pedigree in compressed texttex

# Session Log Gramplet - keep track of what you have done, and what records you have vistedvisited

If a link in a Gramplet is to a specific person, then clicking the link will change the Active Person. Double{{-clicking such any link to a specific Gramps item (such as person or family) will bring up the Editor for that item. To edit a linked person without changing the Active Person, right-click on the person link. Depending on the type of entry, double-clicking any row in a Quick View table will either select more specific data (drill down) or bring up the editor.}}

=Gramplets available in the Gramplets Dashboard Category=

This section When you first start the Dashboard Category you will describe each gramplet available from see two default Gramplets; the [[Gramps_4.0_Wiki_Manual_-_Main_Window#Gramplets_Category|Gramplets Category]] '''Welcome to Gramps (Message) Gramplet''' and its basic functionalitythe '''Top Surnames Gramplet'''.

{{man note|Changing settings|You can change This section describes each gramplet available from the settings of the Gramplets by editing your '''~/[[Gramps_4.gramps/gramplets.ini''' file. But you can only do that when GRAMPS is not running. Just bring up the ''gramplets.ini'' file in a text editor 0_Wiki_Manual_-_Categories#Dashboard_Category|Dashboard Category]] and make the desired changes. You can change the title of the Gramplet by changing the section name (surrounded by square brackets). These options will be able to be changed via the Gramplet View in the next version of GRAMPSits basic functionality. If you have an idea for additional Gramplets, please let us know!}}

[[Image:AgeOnReportAgeOnDate-QV-ResultExample-gramplet-40.png|right|thumb|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Age On Date Quick Report]]

This Gramplet gives you the possibility of entering a date in an entry field. If you click {{man button|Run}} the Gramplet will compute the ages for everyone in your Family Tree living on that Date. The date must be entered in a format that Gramps accepts.

You can then sort the Quick Report by the age column, Name and double-click Age columns. Right clicking the row to view or editopens a context menu for opening Person Editor and activating the person.

The Age Stats gramplet shows graphs of the breakdown of particular 5 years age spans, of three stats: all people, difference between father and child and difference between mother and child. Clicking on a row will bring up the associated peoplein Quick Report. Double clicking a row in a stats opens a Quick Report of all people contained in the row. You can sort the Quick Report by the Name, Birth Date and Name Type columns. Right clicking the row opens a context menu for opening Person Editor and activating the person.

[[Image:CalendargadgetCalendar-detached-gramplet-40.png|right|thumb|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Calendar]]

[[Image:RecordsGrampletRecords-detached-gramplet-40.png|right|thumb|350px|Fig {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Records Gramplet]]

== TODO To Do Gramplet ==[[Image:TODOListToDoList-detachedsidebar-gramplet-40.png|right|thumb|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} TODO To Do Gramplet]]

The TODO gramplet A To Do Gramplet is free form text area. You can use this area to put some notes, remarks, things you should to get your research going. There are several other TODO To Do programs (e.g. Tomboy e.a.) but this Gramplet is these Gramplets are useful as the information stays within the Grampsdatabase.

(In future versions, To Do Gramplets allow you will be able to save links create notes and attach them to Gramps items (like peopleobjects. For example, events, and familiesyou can add a Person To Do Gramplet to the sidebar of the Person View. This Notes added using this Gramplet will allow you be attached to keep the currently active person. There is a group of links that you are working on togetherTo Do Gramplet for each Gramps primary object type. {{bug|???}})

The text There is persistent between sessions. The data is saved to disk when you exit Gramps. You can open more TODO also To Do gramplet available for the Dashboard that lists to save different kinds of topics or organize your info. Change all To Do notes in the title of database, together with the gramplet by editing the section name in ~/.gramps/gramps34/grampletsobject to which they are attached.ini

[[Image:AttributesGrampletAttributes-detached-gramplet-40.png|left|thumb|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Attributes Gramplet]]

[[Image:DescendantGrampletDescendant-detached-gramplet-40.png|thumb|right|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Descendant Gramplet]]

[[Image:FanChartGrampletFanChart-detached-gramplet-40.png|thumb|right|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Fan Chart Gramplet]]

[[Image:PedigreeGrampletPedigree-detached-gramplet-40.png|thumb|right|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree Gramplet]]

[[Image:RelativesGrampletRelatives-detached-gramplet-40.png|right|thumb|350px|Fig {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relatives Gramplet]]

=== Image Metadata Gramplet ===

[[Image:Image_Metadata_GrampletImageMetadata-detached-gramplet-40.png|thumb|right|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Image Metadata Gramplet]]