[[File:QuickViewReport-EditPerson-context-menu-popup-50default-60.png|thumb|left|450px|תפריט הקשר מצג מהיר בעורך אדם]]

מצגים מהירים (בעבר נקראו ''דוחות מהירים'' אך עדין מופיעים ב"עדכוני תוספים זמינים" כ''דוח מהיר'') הם דוחות אליהם ניתן להגיע מתפריטי ההקשר של: אנשים, משפחות וכדומה'. קיימתקבוצה קיימת קבוצה של [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8/he#מצגים_מהירים|מצגים מהירים מובנים]] אותה ניתן להרחיב באמצעות תוספים מסוג QuickView.

==היכן לאחסן אחסון מצגים מהירים שיצרתישנוצרו באופן אישי==

קוד הדוח המהיר פלט דוח מהיר יראה כך:[[File:QuickViewReport-Siblings-example-60.png|thumb|left|450px|פלט תוצאת מצג מהיר לדוגמה]]

תחילה נדרש לייצור קובץ רישום גרמפס בגרמפס (<code>*.gpr.py</code>), לכן יש ליצור הרישום לגרמפס נדרש כדי שגרמפס יזהה את הדוח. הרישום מתבצע על ידי יצירת קובץ פייתון פיתון בשם <code>Siblings.gpr.py</code> ולהוסיף לתוכו את התוכן הבא:

Now create a python file named לאחר רישום המצג המהיר בגרפס, אפשר לייצור את הקובץ שמכיל את הקוד שנכתב בשפת פיתון. לשם כך יש לייצר קובץ פיתון נוסף בשם <code>siblings.py</code> and add the following contentולהוסיף לתוכו את התוכן הבא ולשמור את הקובץ באותה מחיצה בה נשמר קובץ הרישום בגרמפס:<div dir="ltr">

כעת ננתח את קטעי הקוד השונים שנכללו בשני הקבצים שנשמרו קודם לכן.<br>1. קובץ הרישום [[Quick_Views/he#siblings2.gpr.py|siblings2.gpr.py]] . גרמפס יחפש בקובץ הרישום את הפונקציה '''register''' שמופיעה בתחתית הקובץ. להלן פירוט והסבר על שאר שורות קוד קובץ הרישום:* {{man label|name}} =שם ייחודי: שם שבו יזהה גרמפס את המתקע (במקרה זה זהו דוח המצג המהיר), אין להשתמש ברווחים או בסמלים מוזרים. בדוגמה שלעיל נוספה לשם הסיפרה '2' כדי למנוע התנגשויות עם [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8/he#צאצאים|מצג צאצאים מהיר]].* [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L159-L171 {{man label|סוג־אב}}] =קבוע מיוחד שמציין היכן יוצג הדוח. ניתן להשתמש ב־'''CATEGORY_QR_PERSON''' כדי לצפות בדוח בעורך מצג אדם, או '''CATEGORY_QR_FAMILY''' כדי לצפות בדוח בעורך מצג משפחה. (CATEGORY_QR_DATE מיועד לדוחות שניתן להטמיע בתוך דוחות אחרים מכיוון שלא קיים סוג־אב "תאריך").* {{man label|run_func}} =Analysisהיא הפונקציה אותה מייצרים בתוסף זה ואותה יבצע גרמפס כאשר משתמש יבחר את הדוח המהיר הזה מתפריט ההקשר.* [https: registering the report//github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L58-L69 {{man label|מצב}}] =מצב הדוח שנוצר ''', '''לא יציב''', ''יציב''', '''ניסוי''' או '''בטא'''* {{man label|translated_name}} = שם הדוח כפי שיופיע בתפריט* {{man label|description}} =תיאור קצר על התוסף ומטרתו. יופיע כרמז צץ מעל התפריט* {{man label|author_name}} =שם יוצר המתקע* {{man label|author_email}}=דוא"ל יוצר המתקע, כדי שמשתמשים יוכלו לשלוח את ברכתם, או לבקש תיקוני תקלים והצעות לשינויים...

Let's analyse the החל בגירסת גרמפס 5.2 נוספו מספר מאפייני [[Quick_Views#siblings2https://github.gpr.py|siblings2.gpr.py]com/gramps-project/gramps/pull/1451 רישום] file above. We start at the bottom where the report is registered with '''register'''. This is the function Gramps will look for in your file. You need to giveחדשים:*{{man label|namehelp_url}} = a unique name: a name Gramps identifies the plugin with, don't use spaces or strange symbols. In this case, we add a '2' to the name to avoid conflicts with the builtin [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8#Siblings|siblings quickview]].עמוד המרשתת שייפתח בעת השימוש בעזרה* [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L159L71-L171 L76 {{man label|categoryaudience}}] = a special constant indicating where the report will be shown. You can use 'קהל יעד, אפשרויות סינון: 'כולם'CATEGORY_QR_PERSON''' to see the report on person editor and view, or 'מפתחים'ו'CATEGORY_QR_FAMILY''' to see the report on family editor or viewמומחים. (CATEGORY_QR_DATE is for reports that can be embedded in other reports since there is no "Date" category.)*{{man label|run_funcmaintainers}} = the function you create in this plugin and that Gramps will execute when the user selects your quick report in the menuשם האדם שמתחזק כעת את התוסף, במידה ששונה מ־author_name* {{man label|translated_namemaintainers_email}} = the name of the report as it will appear in the menuדוא"ל של האדם שמתחזק כעת את התוסף, במידה ששונה מכתובת author_email* [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L58L297-L69 L299 {{man label|statusrequires_mod}}] = is your report '''Stable''', '''Unstable''', '''Experimental''' and '''Beta'''* [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L300-L303 {{man label|descriptionrequires_gi}} = a description of what your plugin does], [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg. This appears in a tooltip over the menu* py#L304-L306 {{man label|author_name}} = your name* {{man label|author_emailrequires_exe}}] = your email, so people can congratulate you with your work, or ask for bug fixes..האם קיימות דרישות קדם לתוסף.

And beginning with Gramps 5.2 version, there are [https://github.com/gramps-project/gramps/pull/1451 additional registration properties]: * {{man label|help_url}} = a webpage that will be opened when using the Help* [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L71-L76 {{man label|audience}}] = filtering options=ניתוח הקוד: ‘All’, ‘Developer’ and ‘Expert’.* {{man label|maintainers}} פונקציית הריצה= name of person currently maintaining the addon, if different from the author_name* {{man label|maintainers_email}} = email of person currently maintaining the addon, if different from the author_email* [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L297-L299 {{man label|requires_mod}}], [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L300-L303 {{man label|requires_gi}}], [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L304-L306 {{man label|requires_exe}}] = if the addon has prerequisites.

===Analysis: the run function=== Now lets analyse the 2. קובץ הריצה [[Quick_Views/he#siblings.py|siblings.py]] file. If the user clicks in the quick view report menu on your report, the run function is executed with the following three parameters:

Soבדוגמה זו, your report receives from Gramps the currently opened database name on which to work, the document on which to write, and the person of the object the user is on. For a person quick view report, this is a person, for family, a family. In this example, the function called is הפונקציה שתקרא היא:<div dir="ltr">

===Analysisניתוח קטע קוד: accessing the dataגישה לנתונים===Now that your plugin runsלאחר השלמת פונקציית הקיצה של המצג המהיר, you need to open the databaseניתן לטפל בפתיחת מסד הנתונים, start the documentהפעלת המסמך, access data, and write it outגישה לנתונים וכתיבתם על המסמך. We do this using the פעולות אלו מתבצעות באמצעות [[Simple Access API/he|Simple Database מנשק APIגישה פשוטה למסד הנתונים]].  So, the following code:

</div>prepares everything. Then we write a title on the document, an empty line under itכעת ניתן לטפל בכותרת שתופיע על המסמך: שורת כותרת , and a headerשורה ריקה מתחת לשורת הכותרת וכותרת עליונה, with the titleבאמצעות פונקציית הכותרת, paragraph and header functionהפסקה וראש העמוד:<div dir="ltr">

</div>Note that we use an underscore לתשומת לב! קו תחתון (<code>_</code>) to indicate every string that requires translationמציין מחרוזת שמצריכות תרגום, which comes from the lineמחרוזות אלו ניתנות לשליפה לתוך קובץ &lrm;.pot וזה מגיע מהשורה:<div dir="ltr">

</div>Here, the easy access classes from the כאן נעשה שימוש במחלקות הגישה הקלה מ־[[Simple Access API/he|מנשק API גישה פשוטה למסד הנתונים]] have been used to quickly achieve what we wantכדי להשיג במהירות את המטרה ללא הצורך לכתוב שורות קוד רבות נוספות.

לקריאה נוספת: [https://github.com/gramps-project/gramps/tree/master/gramps/plugins/quickview מצגים מהיריםמצג מהיר]