Difference between revisions of "Admin Reports Floating Editor"

From TNG_Wiki
Jump to navigation Jump to search
(Created page with "{{construction |notes=This mod is in a beta testing state. I've been using it for a while, in TNGv11.1, but * It needs to be tested on other TNG sites, * I haven't completed...")
 
(Text replacement - "robinrichmond.org" to "robinrichmond.com")
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{construction
+
{{V12_cust_text}}  
|notes=This mod is in a beta testing state. I've been using it for a while, in TNGv11.1, but
 
* It needs to be tested on other TNG sites,
 
* I haven't completed the description below, and
 
* I haven't created the visualizations this article needs
 
 
 
In truth, I have over 40 new and updated mods in this state, and I'd appreciate whatever help anyone can offer.
 
So, it would be great if you could download the mod and let me know how it works for you.
 
And if you're up for it, screenshots from before the mod was installed and after (annotated or not) would be a great help. :-)
 
You're welcome to edit the Wiki article, or just email them to me.
 
My email username is '''mail'', and my email domain is robinrichmond.com.
 
 
 
Thanks in advance.
 
Robin Richmond [[User:Rmcrae|Rmcrae]] ([[User talk:Rmcrae|talk]]) 16:40, 29 May 2017 (CDT)
 
}}
 
 
{{TNGmod
 
{{TNGmod
 
| mod_name        =  Reports-Floating Editor
 
| mod_name        =  Reports-Floating Editor
|  mod_summary    = Moves blocks of fields in admin_editreport so they can float side-by side, so the form is easier to see and use on a wide screen. They float above-and-below on narrower screens.
+
|  mod_summary    = Modifies the report edit form at Admin>>Reports>>Edit:
 
| mod_validation  =  
 
| mod_validation  =  
| download_link  =  For {{Tv110}}
+
| mod_last_update = 25 Oct 2018
[[Media:reports-floating_editor_v11.0.0.5a.zip|reports-floating_editor_v11.0.0.5a.zip]]
+
| download_link  =  [[Media:Reports-Floating_Editor_v12.0.0.6.zip|12.0.0.6]]{{Tv120}}
 +
<div>See the [[#Revision_History|Revision History]]</div>
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
Line 25: Line 12:
 
| mod_contact    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form]
 
| mod_contact    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form]
 
| mod_support    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums]
 
| mod_support    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums]
| mod_version    = 11.0.0.5a
+
| mod_version    = v12.0.0.06
| min_TNG_ver    = 11.0.0
+
| min_TNG_ver    = 12.0
| max_TNG_ver    = at least 11.1.1 beta2
+
| max_TNG_ver    = at least 12.0.2
 
|  TNG_file_list  = admin_editreport.php, cust_text.php English  
 
|  TNG_file_list  = admin_editreport.php, cust_text.php English  
 
| related_mods  = [[Show Mod Names]] (optional)
 
| related_mods  = [[Show Mod Names]] (optional)
| notes    =   
+
| notes    =  
}}
+
   
 
+
}}== Purpose of the Mod ==
 +
To improve the usability of the Report Editor by hiding blocks of fields as appropriate, and allowing blocks of fields to float side-by side on a wide screen.
 
{| style="margin-right:0.5 em;" align="right"  
 
{| style="margin-right:0.5 em;" align="right"  
 
| __TOC__
 
| __TOC__
 
|}
 
|}
 +
==Installation==
 +
This mod uses the standard installation procedure. {{RobinInstallationBoilerplate}}
  
== Purpose of the Mod ==
+
==Requirements==
Moves blocks of fields in admin_editreport so they can float side-by side, so the form is easier to see and use on a wide screen.
+
* A working TNG installation.
They float above-and-below on narrower screens. The DisplayModNames mod is now optional.
+
* An installed current version of the [[Mod Manager]].
  
 +
==Conflicts==
 +
No conflicts. No other published mods target the Report Editor.
  
== Mod Conflicts ==
+
==Related Mods==
No known conflicts.
+
* [[Admin Reports List]] modifies admin_reports.php, which calls admin_editreport.php, which is modified by ''this'' mod. [[Admin Reports List]] affects admin_editreport.php by changing the way that new reports are created.
 
+
* This mod saves data that can be used by the [[Show Mod Names]] utility mod, but is '''not dependent on''' [[Show Mod Names]].
== Mod Dependencies ==
 
This mod saves data that can be used by the [[Show Mod Names]] utility mod, but is ''’not dependent on’'' [[Show Mod Names]].
 
  
 
==Requirements==
 
==Requirements==
Line 52: Line 42:
 
* An installed current version of the [[Mod Manager]].
 
* An installed current version of the [[Mod Manager]].
 
* You should backup files listed in the panel on the right.
 
* You should backup files listed in the panel on the right.
 
+
==Automated Installation==
==Installation==
 
 
# Remove and delete previous version of this mod.
 
# Remove and delete previous version of this mod.
# Backup the files updated by this mod.  They are listed in the panel at the upper right.  
+
# Backup the files updated by this mod.  They are listed in the panel at the upper right.
# Download the .zip file, and extract its .cfg file to the mods folder.
+
# Download the .zip file. Upload and Extract to the mods folder.
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod Manager - Installing Config Files]].
+
# Follow the normal automated installation for Mod Manager, as shown in the example [[Mod Manager - Installing Config Files]] to  install.
  
 
== In the event of a problem ==
 
== In the event of a problem ==
Line 67: Line 56:
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-
| style="border:thin solid black;vertical-align:top;" | '''Screen Name <span style="color: red">BEFORE:</span>'''<br/>
+
| <span style="color: red">'''BEFORE'''</span> Requires considerable vertical scrolling
[[Image:screenshot-before1.png]]
+
| <span style="color: red">'''AFTER'''</span> If the report has a SQL statement and no report-builder field values, the report-builder-fields are hidden. Note the message and button in the enlarged inset.
|-
+
|-
| style="border:thin solid black;vertical-align:top;" | ''' Screen Name <span style="color: red">AFTER:</span>'''<br/>
+
| [[file:floating_report_editor-before.png | 243x666px]]
[[Image:screenshot-after1.png]]
+
| style="vertical-align:top;" | [[file:floating_report_editor-after-sql.png]]
 +
|-
 +
| colspan="2"| <span style="color: red">'''AFTER'''</span> If the report has report-builder field values and no SQL statement, the SQL statement field is hidden. This visualization is on a screen wide enough for the three report-builder fieldsets to float side-by-side. Note the message and button in the enlarged inset.
 +
|-
 +
| colspan="2" | [[file:floating_report_editor-after-builder.png]]
 +
|-
 +
| colspan="2" | <span style="color: red">'''AFTER'''</span> If the report is empty or has report-builder field values AND a SQL statement. This visualization is on a screen only wide enough for two fieldsets to float side-by-side. A narrower screen would look like the BEFORE visualization.  Note the message and button in the enlarged inset.
 
|-
 
|-
| style="border:thin solid black;vertical-align:top;" | '''Another screen <span style="color: red">BEFORE:</span>'''<br/>
+
| colspan="2" | [[file:floating_report_editor-after-2x2.png]]
[[Image:screenshot-before2.png]]
 
|-
 
| style="border:thin solid black;vertical-align:top;" | '''Another screen <span style="color: red">AFTER:</span>'''<br/>
 
[[Image:screenshot-after2.png]]
 
 
|}
 
|}
  
 +
== Issues ==
 +
With Mozilla Firefox, at certain browser widths, and when all 4 fieldsets are displayed, the direct SQL entry field can float to the right and part-way off the screen. This can be corrected by hiding the SQL field, or the report-builder fields, or by adjusting the width of the screen.
 +
== Revision History ==
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
|-
+
! Mod Version !! TNG Version !! Date !! Note
| style="border:thin solid black;vertical-align:top;" | '''<span style="color: red">BEFORE:</span> <span style='white-space:nowrap'>Screen Name </span> mod'''
+
|- style="vertical-align:top;"
| [[Image:narrow_image_on_right-before1.png]]
+
|[[Media:Reports-Floating_Editor_v12.0.0.6.zip|12.0.0.6]]
|-  
+
| 12.0 - 12.0.2+
| style="border:thin solid black;vertical-align:top;" | '''<span style="color: red">AFTER:</span> <span style='white-space:nowrap'> Screen Name </span> mod'''
+
| 21Dec2018
| [[Image: narrow_image_on_right-after1.png]]
+
| - In admin_reports.php, the Add New tab invokes admin_editreport.php<br>
|-
+
- admin_editreport.php now can start the record from scratch when it is not given a reportID.<br>
| style="border:thin solid black;vertical-align:top;" | '''<span style="color: red">BEFORE:</span> Another screen'''
+
- made compatible with TNGv12.
| [[Image: narrow_image_on_right-before2.png]]
+
|- style="vertical-align:top;"  
 
|-  
 
|-  
| style="border:thin solid black;vertical-align:top;" | '''<span style="color: red">AFTER:</span> Another screen'''
+
| 11.0.0.5p
| [[narrow_image_on_right-after2.png]]
+
| 10.1.0-11.1.2+
|}
+
| 07 Nov 2017
 
+
| Removed the second line from the cust_text.php target location search string
== Mod Change History ==
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
! Mod Version
 
! TNG Versions
 
! Date
 
! Note
 
 
|-  
 
|-  
 
| 11.0.0.5a
 
| 11.0.0.5a
| 11.0.0 and up
+
| 11.0.0+
| 29-May-2017
+
| 29 May 2017
| New mod – Beta Status.
+
| New name; See [[Floating Report Editor]] for older history.
 +
* Wrapped "save as copy" checkbox in a no-word-wrap label element - thus both keeping it from wrapping, and allowing a click on the text to check the box
 +
* Added a "Run Report" button that does the the same as the "test" button in the search results table in admin_reports.php; that is, it launches showreport.php in a new window.
 +
* The [[Display Mod Names]] mod is now optional
 
|}
 
|}
  
 
== Sites using this mod ==
 
== Sites using this mod ==
 
If you download and install this mod, please add your site to the table below.
 
If you download and install this mod, please add your site to the table below.
 
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-
Line 124: Line 113:
 
| [[User:Robinrichm|Robin Richmond]]
 
| [[User:Robinrichm|Robin Richmond]]
 
| Mod developer
 
| Mod developer
| XXX-mod-version-number-XXX
+
| 11.0.0.5a
 
| 11.1
 
| 11.1
 
| English
 
| English
 +
|-
 +
| [http://www.wortelboer.tk/ Wortelboer Genealogy]
 +
| [[User:Bernard57|Bernard Wortelboer]]
 +
|
 +
| 11.0.0.4
 +
| 11.0.0
 +
| NL/EN
 +
|-
 +
| [http://www.djcm.dk/ DJCM.DK]
 +
| [[User:clausm|Claus Martinussen]]
 +
|
 +
| 11.0.0.4
 +
| 11.0.0
 +
| Danish, English
 +
|-
 +
| [https://www.martius-familie.de/ Martius family]
 +
| [[User:Hemar|Hendrik Martius]]
 +
| Half public
 +
| 11.0.0.5p
 +
| 12.0.1
 +
| DE, EN, FR, NL
 
|}
 
|}
  
 +
[[Category:Mods for TNG v12]]
 
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v11]]
 
[[Category:admin_editreport.php mods]]
 
[[Category:admin_editreport.php mods]]
 
[[Category:Cust text.php English mods]]
 
[[Category:Cust text.php English mods]]

Revision as of 18:52, 5 February 2020


Ambox notice.png The latest version of this mod uses the guidelines for TNG v12+ cust_text.php files. If you are using TNGv12+, and any cust_text.php file in this mod is marked with a Bad Target error, you need to update your cust_text.php files before you can install this mod. [Show instructions]

If you upgraded to TNGv12+, and did not update your cust_text.php files as instructed in the upgrade readme script, then you must use the TNG Mod Manager to update them. To do so:

  1. Go to Mod Manager, and select its "Recommended Updates" tab.
    (If the "Recommended Updates" tab is not visible, then go to the Mod Manager Options tab, select "Display Settings", and turn on the "Recommended Updates" tab.)
  2. Click the "Update" button in the "Recommended Updates" tab.
    Installed mods do not interfere with the update, and if you already have (or think you may have) run this update, it will not hurt for you to run it again.

[See details in the TNGv12 Change Impacts Article][Hide the instructions]

TNG 14.0
TNG 13.0
TNG 12.0



Reports-Floating Editor
Summary Modifies the report edit form at Admin>>Reports>>Edit:
Validation
Mod Updated 25 Oct 2018
Download link 12.0.0.6
TNG 12.0
Download stats
Author(s) Robin Richmond
Homepage Robin Richmond's Genealogy Database
Mod Support My Mod Support form or TNG Community Forums
Contact Developer My Mod Support form
Latest Mod v12.0.0.06
Min TNG V 12.0
Max TNG V at least 12.0.2
Files modified
admin_editreport.php, cust_text.php English
Related Mods
Show Mod Names (optional)
Notes

Purpose of the Mod

To improve the usability of the Report Editor by hiding blocks of fields as appropriate, and allowing blocks of fields to float side-by side on a wide screen.

Installation

This mod uses the standard installation procedure. [Show Installation Details]

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager.
  • You should backup files listed in the panel on the right.

Procedure

  1. Remove and delete previous version of this mod.
  2. Backup the files updated by this mod. They are listed in the panel at the upper right.
  3. Download the .zip file, Extract its .cfg file to the mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

Problems?

  1. Try using the Mod Manager Remove capability
  2. Contact me through My Mod Support form.
[Hide Details]

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager.

Conflicts

No conflicts. No other published mods target the Report Editor.

Related Mods

  • Admin Reports List modifies admin_reports.php, which calls admin_editreport.php, which is modified by this mod. Admin Reports List affects admin_editreport.php by changing the way that new reports are created.
  • This mod saves data that can be used by the Show Mod Names utility mod, but is not dependent on Show Mod Names.

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager.
  • You should backup files listed in the panel on the right.

Automated Installation

  1. Remove and delete previous version of this mod.
  2. Backup the files updated by this mod. They are listed in the panel at the upper right.
  3. Download the .zip file. Upload and Extract to the mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install.

In the event of a problem

  1. Try using the Mod Manager Remove capability
  2. Contact me through My Mod Support form.

Visualizations

BEFORE Requires considerable vertical scrolling AFTER If the report has a SQL statement and no report-builder field values, the report-builder-fields are hidden. Note the message and button in the enlarged inset.
Floating report editor-before.png Floating report editor-after-sql.png
AFTER If the report has report-builder field values and no SQL statement, the SQL statement field is hidden. This visualization is on a screen wide enough for the three report-builder fieldsets to float side-by-side. Note the message and button in the enlarged inset.
Floating report editor-after-builder.png
AFTER If the report is empty or has report-builder field values AND a SQL statement. This visualization is on a screen only wide enough for two fieldsets to float side-by-side. A narrower screen would look like the BEFORE visualization. Note the message and button in the enlarged inset.
Floating report editor-after-2x2.png

Issues

With Mozilla Firefox, at certain browser widths, and when all 4 fieldsets are displayed, the direct SQL entry field can float to the right and part-way off the screen. This can be corrected by hiding the SQL field, or the report-builder fields, or by adjusting the width of the screen.

Revision History

Mod Version TNG Version Date Note
12.0.0.6 12.0 - 12.0.2+ 21Dec2018 - In admin_reports.php, the Add New tab invokes admin_editreport.php

- admin_editreport.php now can start the record from scratch when it is not given a reportID.
- made compatible with TNGv12.

11.0.0.5p 10.1.0-11.1.2+ 07 Nov 2017 Removed the second line from the cust_text.php target location search string
11.0.0.5a 11.0.0+ 29 May 2017 New name; See Floating Report Editor for older history.
  • Wrapped "save as copy" checkbox in a no-word-wrap label element - thus both keeping it from wrapping, and allowing a click on the text to check the box
  • Added a "Run Report" button that does the the same as the "test" button in the search results table in admin_reports.php; that is, it launches showreport.php in a new window.
  • The Display Mod Names mod is now optional

Sites using this mod

If you download and install this mod, please add your site to the table below.

URL User Note Mod-Version TNG-Version User-language
Robin Richmond's Genealogy Database Robin Richmond Mod developer 11.0.0.5a 11.1 English
Wortelboer Genealogy Bernard Wortelboer 11.0.0.4 11.0.0 NL/EN
DJCM.DK Claus Martinussen 11.0.0.4 11.0.0 Danish, English
Martius family Hendrik Martius Half public 11.0.0.5p 12.0.1 DE, EN, FR, NL