[jira] Created: (OFBIZ-1754) An Alternative Help System

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
13 messages Options
Reply | Threaded
Open this post in threaded view
|

[jira] Created: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
An Alternative Help System
--------------------------

                 Key: OFBIZ-1754
                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
             Project: OFBiz
          Issue Type: New Feature
          Components: ALL COMPONENTS
            Reporter: Skip Dever
            Priority: Minor


This is an alternative help system to the one offered by Bruno at:
https://issues.apache.org/jira/browse/OFBIZ-1750

This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl

GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:

                <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
                <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            

header.ftl is modified by adding these lines
href="<@ofbizUrl>LookupTimezones</@ofbizUrl>" class="buttontext">${uiLabelMap.CommonChange}</a></p>
        <#if helpUrl?exists>
          <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
        </#if>        
      </li>

right below:
        <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a

Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:

    <screen name="main">
        <section>
            <actions>
                <set field="helpTag" value="ExampleHelp"/>
            </actions>


The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.

Also included are a few example help screens.  These can be found in help/helpFiles/html/en

There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.

Also included is some seed data to populate the HelpCrossReference table with an entry for the example.

Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.

 

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

[jira] Updated: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)

     [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Skip Dever updated OFBIZ-1754:
------------------------------

    Attachment: htmlhelp.ZIP

> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
> href="<@ofbizUrl>LookupTimezones</@ofbizUrl>" class="buttontext">${uiLabelMap.CommonChange}</a></p>
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
>       </li>
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="ExampleHelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

[jira] Updated: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
In reply to this post by Nicolas Malin (Jira)

     [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Skip Dever updated OFBIZ-1754:
------------------------------

    Attachment: screenshot-1.jpg

This shows the help icon in the upper right.

> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP, screenshot-1.jpg
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
> href="<@ofbizUrl>LookupTimezones</@ofbizUrl>" class="buttontext">${uiLabelMap.CommonChange}</a></p>
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
>       </li>
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="ExampleHelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

[jira] Updated: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
In reply to this post by Nicolas Malin (Jira)

     [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Skip Dever updated OFBIZ-1754:
------------------------------

    Attachment: screenshot-2.jpg

This is an example of the help screen displayed when the help button is pressed.  These help screens are all self contained and editable outside of the ofbiz build.

> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
> href="<@ofbizUrl>LookupTimezones</@ofbizUrl>" class="buttontext">${uiLabelMap.CommonChange}</a></p>
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
>       </li>
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="ExampleHelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

[jira] Updated: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
In reply to this post by Nicolas Malin (Jira)

     [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Skip Dever updated OFBIZ-1754:
------------------------------

    Description:
This is an alternative help system to the one offered by Bruno at:
https://issues.apache.org/jira/browse/OFBIZ-1750

This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl

GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:

                <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
                <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            

header.ftl is modified by adding these lines
href="<@ofbizUrl>LookupTimezones</@ofbizUrl>" class="buttontext">${uiLabelMap.CommonChange}</a></p>
        <#if helpUrl?exists>
          <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
        </#if>        
      </li>

right below:
        <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a

Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:

    <screen name="main">
        <section>
            <actions>
                <set field="helpTag" value="examplehelp"/>
            </actions>


The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.

Also included are a few example help screens.  These can be found in help/helpFiles/html/en

There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.

Also included is some seed data to populate the HelpCrossReference table with an entry for the example.

Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.

One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code our or import your help cross references with the helpTag in lower case as I did.

 

  was:
This is an alternative help system to the one offered by Bruno at:
https://issues.apache.org/jira/browse/OFBIZ-1750

This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl

GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:

                <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
                <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            

header.ftl is modified by adding these lines
href="<@ofbizUrl>LookupTimezones</@ofbizUrl>" class="buttontext">${uiLabelMap.CommonChange}</a></p>
        <#if helpUrl?exists>
          <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
        </#if>        
      </li>

right below:
        <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a

Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:

    <screen name="main">
        <section>
            <actions>
                <set field="helpTag" value="ExampleHelp"/>
            </actions>


The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.

Also included are a few example help screens.  These can be found in help/helpFiles/html/en

There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.

Also included is some seed data to populate the HelpCrossReference table with an entry for the example.

Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.

 


> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
> href="<@ofbizUrl>LookupTimezones</@ofbizUrl>" class="buttontext">${uiLabelMap.CommonChange}</a></p>
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
>       </li>
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="examplehelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
> One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code our or import your help cross references with the helpTag in lower case as I did.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

[jira] Updated: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
In reply to this post by Nicolas Malin (Jira)

     [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Skip Dever updated OFBIZ-1754:
------------------------------

    Description:
This is an alternative help system to the one offered by Bruno at:
https://issues.apache.org/jira/browse/OFBIZ-1750

This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl

GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:

                <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
                <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            

header.ftl is modified by adding these lines
        <#if helpUrl?exists>
          <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
        </#if>        

right below:
        <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a

Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:

    <screen name="main">
        <section>
            <actions>
                <set field="helpTag" value="examplehelp"/>
            </actions>


The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.

Also included are a few example help screens.  These can be found in help/helpFiles/html/en

There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.

Also included is some seed data to populate the HelpCrossReference table with an entry for the example.

Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.

One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code our or import your help cross references with the helpTag in lower case as I did.

 

  was:
This is an alternative help system to the one offered by Bruno at:
https://issues.apache.org/jira/browse/OFBIZ-1750

This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl

GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:

                <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
                <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            

header.ftl is modified by adding these lines
href="<@ofbizUrl>LookupTimezones</@ofbizUrl>" class="buttontext">${uiLabelMap.CommonChange}</a></p>
        <#if helpUrl?exists>
          <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
        </#if>        
      </li>

right below:
        <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a

Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:

    <screen name="main">
        <section>
            <actions>
                <set field="helpTag" value="examplehelp"/>
            </actions>


The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.

Also included are a few example help screens.  These can be found in help/helpFiles/html/en

There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.

Also included is some seed data to populate the HelpCrossReference table with an entry for the example.

Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.

One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code our or import your help cross references with the helpTag in lower case as I did.

 


> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="examplehelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
> One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code our or import your help cross references with the helpTag in lower case as I did.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

[jira] Updated: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
In reply to this post by Nicolas Malin (Jira)

     [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Skip Dever updated OFBIZ-1754:
------------------------------

    Description:
This is an alternative help system to the one offered by Bruno at:
https://issues.apache.org/jira/browse/OFBIZ-1750

This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl

GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:

                <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
                <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            

header.ftl is modified by adding these lines
        <#if helpUrl?exists>
          <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
        </#if>        

right below:
        <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a

Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:

    <screen name="main">
        <section>
            <actions>
                <set field="helpTag" value="examplehelp"/>
            </actions>


The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.

Also included are a few example help screens.  These can be found in help/helpFiles/html/en

There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.

Also included is some seed data to populate the HelpCrossReference table with an entry for the example.

Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.

Here is a sample entry for the HelpCrossReference entity:

<HelpCrossReference helpTag="examplehelp" helpFileName="examplehelp.html" />

The bash script that loads the pages uses the current local to extract the language.  With english, this is "en".  It then creates a url rooted in helpFiles/html with the language and the html file obtained from HelpCrossReference.

One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code out or import your help cross references with the helpTag in lower case as I did.

 

  was:
This is an alternative help system to the one offered by Bruno at:
https://issues.apache.org/jira/browse/OFBIZ-1750

This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl

GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:

                <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
                <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            

header.ftl is modified by adding these lines
        <#if helpUrl?exists>
          <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
        </#if>        

right below:
        <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a

Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:

    <screen name="main">
        <section>
            <actions>
                <set field="helpTag" value="examplehelp"/>
            </actions>


The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.

Also included are a few example help screens.  These can be found in help/helpFiles/html/en

There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.

Also included is some seed data to populate the HelpCrossReference table with an entry for the example.

Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.

One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code our or import your help cross references with the helpTag in lower case as I did.

 


> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="examplehelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
> Here is a sample entry for the HelpCrossReference entity:
> <HelpCrossReference helpTag="examplehelp" helpFileName="examplehelp.html" />
> The bash script that loads the pages uses the current local to extract the language.  With english, this is "en".  It then creates a url rooted in helpFiles/html with the language and the html file obtained from HelpCrossReference.
> One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code out or import your help cross references with the helpTag in lower case as I did.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

[jira] Commented: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
In reply to this post by Nicolas Malin (Jira)

    [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12589752#action_12589752 ]

Adrian Crum commented on OFBIZ-1754:
------------------------------------

I'm thinking a good help system design might be a combination of both Jira issues. I like Bruno's approach of adding a widget attribute - which means the help icon only appears when help is available. I also like Skip's help screen layout. Maybe we could find a way to combine the two.


> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="examplehelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
> Here is a sample entry for the HelpCrossReference entity:
> <HelpCrossReference helpTag="examplehelp" helpFileName="examplehelp.html" />
> The bash script that loads the pages uses the current local to extract the language.  With english, this is "en".  It then creates a url rooted in helpFiles/html with the language and the html file obtained from HelpCrossReference.
> One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code out or import your help cross references with the helpTag in lower case as I did.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

[jira] Commented: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
In reply to this post by Nicolas Malin (Jira)

    [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12589760#action_12589760 ]

Skip Dever commented on OFBIZ-1754:
-----------------------------------

Adrian

This help only shows the help icon if help has been defined in the screen widget with a set-field tag.  If no set-field tag, no help icon.

If you download and install the zip file and modify the example as shown (the CommonScreens.xml file for the example is included in the zip file), you will only have help available when the example tab is clicked on.  All other tabs show no help icon.

Skip

> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="examplehelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
> Here is a sample entry for the HelpCrossReference entity:
> <HelpCrossReference helpTag="examplehelp" helpFileName="examplehelp.html" />
> The bash script that loads the pages uses the current local to extract the language.  With english, this is "en".  It then creates a url rooted in helpFiles/html with the language and the html file obtained from HelpCrossReference.
> One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code out or import your help cross references with the helpTag in lower case as I did.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

Re: [jira] Commented: (OFBIZ-1754) An Alternative Help System

pierre-29
Hi all,

This work on help system is very interesting. I wanted to know if the
pages of help could use the content module because I think that would
simplify the maintenance of this help and uses functionalities which are
already developed.

Pierre

Skip Dever (JIRA) a écrit :

>     [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12589760#action_12589760 ]
>
> Skip Dever commented on OFBIZ-1754:
> -----------------------------------
>
> Adrian
>
> This help only shows the help icon if help has been defined in the screen widget with a set-field tag.  If no set-field tag, no help icon.
>
> If you download and install the zip file and modify the example as shown (the CommonScreens.xml file for the example is included in the zip file), you will only have help available when the example tab is clicked on.  All other tabs show no help icon.
>
> Skip
>
>  
>> An Alternative Help System
>> --------------------------
>>
>>                 Key: OFBIZ-1754
>>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>>             Project: OFBiz
>>          Issue Type: New Feature
>>          Components: ALL COMPONENTS
>>            Reporter: Skip Dever
>>            Priority: Minor
>>         Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
>>
>>
>> This is an alternative help system to the one offered by Bruno at:
>> https://issues.apache.org/jira/browse/OFBIZ-1750
>> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
>> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
>> header.ftl is modified by adding these lines
>>         <#if helpUrl?exists>
>>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>>         </#if>        
>> right below:
>>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
>> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>>     <screen name="main">
>>         <section>
>>             <actions>
>>                 <set field="helpTag" value="examplehelp"/>
>>             </actions>
>> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
>> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
>> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
>> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
>> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
>> Here is a sample entry for the HelpCrossReference entity:
>> <HelpCrossReference helpTag="examplehelp" helpFileName="examplehelp.html" />
>> The bash script that loads the pages uses the current local to extract the language.  With english, this is "en".  It then creates a url rooted in helpFiles/html with the language and the html file obtained from HelpCrossReference.
>> One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code out or import your help cross references with the helpTag in lower case as I did.
>>  
>>    
>
>  

Reply | Threaded
Open this post in threaded view
|

Re: [jira] Commented: (OFBIZ-1754) An Alternative Help System

Bruno Busco
Both systems simply require a bunch of urls to point to. The urls can be
both static local html pages, web sites, local or even remote content pages.
Using the helpurls.suffix variable it will be possible to specify an
eventual "?locale=it" parameter that can be useful cor CMS.

-Bruno

2008/4/17, pierre.gaudin <[hidden email]>:

>
> Hi all,
>
> This work on help system is very interesting. I wanted to know if the
> pages of help could use the content module because I think that would
> simplify the maintenance of this help and uses functionalities which are
> already developed.
>
> Pierre
>
> Skip Dever (JIRA) a écrit :
>
> >    [
> > https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12589760#action_12589760]
> > Skip Dever commented on OFBIZ-1754:
> > -----------------------------------
> >
> > Adrian
> >
> > This help only shows the help icon if help has been defined in the
> > screen widget with a set-field tag.  If no set-field tag, no help icon.
> >
> > If you download and install the zip file and modify the example as shown
> > (the CommonScreens.xml file for the example is included in the zip file),
> > you will only have help available when the example tab is clicked on.  All
> > other tabs show no help icon.
> >
> > Skip
> >
> >
> >
> > > An Alternative Help System
> > > --------------------------
> > >
> > >                Key: OFBIZ-1754
> > >                URL: https://issues.apache.org/jira/browse/OFBIZ-1754
> > >            Project: OFBiz
> > >         Issue Type: New Feature
> > >         Components: ALL COMPONENTS
> > >           Reporter: Skip Dever
> > >           Priority: Minor
> > >        Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
> > >
> > >
> > > This is an alternative help system to the one offered by Bruno at:
> > > https://issues.apache.org/jira/browse/OFBIZ-1750
> > > This one offers simplicity and requires no changes the Ofbiz core
> > > code.  The only modifications required are to the GlobalDecorator screen in
> > > framework/common/widget/CommonScreens.xml and
> > > framework/common/webcommon/includes/header.ftl
> > > GlogalDecorator is modified to call a bash script to load the help url
> > > with these two additions in the actions section:
> > >                <set field="layoutSettings.helpImageUrl"
> > > value="/images/help.gif" global="true"/>
> > >                <script
> > > location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>
> > >                        header.ftl is modified by adding these lines
> > >  <#if helpUrl?exists>
> > >          <p><a target="_blank" href="${helpUrl}"><img
> > > src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
> > >        </#if>        right below:
> > >        <p>${timeZone.getDisplayName(timeZone.useDaylightTime(),
> > > Static["java.util.TimeZone"].LONG, locale)} <a Then, all that is required to
> > > to define a helpTag in each screen that has help available like this in the
> > > example application:
> > >    <screen name="main">
> > >        <section>
> > >            <actions>
> > >                <set field="helpTag" value="examplehelp"/>
> > >            </actions>
> > > The enclosed zip file contains a "help" directory that goes in
> > > hot-deploy.  In addition, I have included the modified test files in the
> > > "framework" directory.
> > > Also included are a few example help screens.  These can be found in
> > > help/helpFiles/html/en
> > > There are only help files for the english language.  You can create
> > > help files for any language by creating a
> > > help/helpFiles/html/<getLanguage()> directory and putting them in there.
> > > Also included is some seed data to populate the HelpCrossReference
> > > table with an entry for the example.
> > > Note that this work was done on a version of Ofbiz from the first of
> > > the year and there may be some differences in the modified framework files.
> > > Here is a sample entry for the HelpCrossReference entity:
> > > <HelpCrossReference helpTag="examplehelp"
> > > helpFileName="examplehelp.html" />
> > > The bash script that loads the pages uses the current local to extract
> > > the language.  With english, this is "en".  It then creates a url rooted in
> > > helpFiles/html with the language and the html file obtained from
> > > HelpCrossReference.
> > > One final note.  The bash script that creates the urls from the help
> > > tags converts all the tags to lower case.  You can comment that code out or
> > > import your help cross references with the helpTag in lower case as I did.
> > >
> > >
> >
> >
> >
>
>
Reply | Threaded
Open this post in threaded view
|

[jira] Commented: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
In reply to this post by Nicolas Malin (Jira)

    [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12642802#action_12642802 ]

Jacques Le Roux commented on OFBIZ-1754:
----------------------------------------

Nobody interested to pursuie in this direction ? Should we close this issue since OFBIZ-1750 is now closed ?

> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="examplehelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
> Here is a sample entry for the HelpCrossReference entity:
> <HelpCrossReference helpTag="examplehelp" helpFileName="examplehelp.html" />
> The bash script that loads the pages uses the current local to extract the language.  With english, this is "en".  It then creates a url rooted in helpFiles/html with the language and the html file obtained from HelpCrossReference.
> One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code out or import your help cross references with the helpTag in lower case as I did.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply | Threaded
Open this post in threaded view
|

[jira] Closed: (OFBIZ-1754) An Alternative Help System

Nicolas Malin (Jira)
In reply to this post by Nicolas Malin (Jira)

     [ https://issues.apache.org/jira/browse/OFBIZ-1754?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Jacques Le Roux closed OFBIZ-1754.
----------------------------------

    Resolution: Later

> An Alternative Help System
> --------------------------
>
>                 Key: OFBIZ-1754
>                 URL: https://issues.apache.org/jira/browse/OFBIZ-1754
>             Project: OFBiz
>          Issue Type: New Feature
>          Components: ALL COMPONENTS
>            Reporter: Skip Dever
>            Priority: Minor
>         Attachments: htmlhelp.ZIP, screenshot-1.jpg, screenshot-2.jpg
>
>
> This is an alternative help system to the one offered by Bruno at:
> https://issues.apache.org/jira/browse/OFBIZ-1750
> This one offers simplicity and requires no changes the Ofbiz core code.  The only modifications required are to the GlobalDecorator screen in framework/common/widget/CommonScreens.xml and framework/common/webcommon/includes/header.ftl
> GlogalDecorator is modified to call a bash script to load the help url with these two additions in the actions section:
>                 <set field="layoutSettings.helpImageUrl" value="/images/help.gif" global="true"/>
>                 <script location="component://help/webapp/help/WEB-INF/actions/gethelpurl.bsh"/>                            
> header.ftl is modified by adding these lines
>         <#if helpUrl?exists>
>           <p><a target="_blank" href="${helpUrl}"><img src="<@ofbizContentUrl>/images/help.gif</@ofbizContentUrl>" alt="Help"/></a>
>         </#if>        
> right below:
>         <p>${timeZone.getDisplayName(timeZone.useDaylightTime(), Static["java.util.TimeZone"].LONG, locale)} <a
> Then, all that is required to to define a helpTag in each screen that has help available like this in the example application:
>     <screen name="main">
>         <section>
>             <actions>
>                 <set field="helpTag" value="examplehelp"/>
>             </actions>
> The enclosed zip file contains a "help" directory that goes in hot-deploy.  In addition, I have included the modified test files in the "framework" directory.
> Also included are a few example help screens.  These can be found in help/helpFiles/html/en
> There are only help files for the english language.  You can create help files for any language by creating a help/helpFiles/html/<getLanguage()> directory and putting them in there.
> Also included is some seed data to populate the HelpCrossReference table with an entry for the example.
> Note that this work was done on a version of Ofbiz from the first of the year and there may be some differences in the modified framework files.
> Here is a sample entry for the HelpCrossReference entity:
> <HelpCrossReference helpTag="examplehelp" helpFileName="examplehelp.html" />
> The bash script that loads the pages uses the current local to extract the language.  With english, this is "en".  It then creates a url rooted in helpFiles/html with the language and the html file obtained from HelpCrossReference.
> One final note.  The bash script that creates the urls from the help tags converts all the tags to lower case.  You can comment that code out or import your help cross references with the helpTag in lower case as I did.
>  

--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.