PPanel


Revision history for PPanel


Revision [4484]

Last edited on 2011-10-16 22:38:43 by webmaster [Fixed UTF-8 issues]
Additions:
Parameters:
name : name in screen, compulsory
Optional is : condition, lock
For almost each xml tag, it's possible to execute a script
before and after the action. These options are:
runBefore : run a program before, no output is shown
runAfter : run a program after, no output is shown
runBeforeOut : run a program before and show output
runAfterOut : run a program after and show output
Example:
<file name="Download a file from internet"
url="http://www.google.nl/intl/nl_nl/images/logo.gif"
target="/tmp/logo.gif"
runAfter="rm /tmp/logo.gif"/>
All four options can be used simultaneously
All xml tags except <directory> can have a script which is
evaluated runtime while the xml file is read. If the script
returns true the xml tag will be shown.
Example:
<execute name="Enable automatic menu downloads"
condition="[ ! -f /var/etc/ppanelautodownload ]"
target="touch /var/etc/ppanelautodownload; echo Automatic downloads enabled"/>
<execute name="Disable automatic menu downloads"
condition="[ -f /var/etc/ppanelautodownload ]"
target="rm -f /var/etc/ppanelautodownload; echo Automatic downloads disabled"/>
Depending on if /var/etc/ppanelautodownload exists, only one of the two is shown.
For almost each xml tag, it's possible to have a confirmation.
If you ommit confirmation, no confirmation will be asked.
If confirmation is "true", you will get a default confirmation.
Otherwise, the confirmation will be the text after confirmation.
Example:
<file name="Download a file from internet"
url="http://www.google.nl/intl/nl_nl/images/logo.gif"
target="/tmp/logo.gif"
confirmation="Do you have internet?"/>
The url option in <tarball>, <file>, <media> and <picture> can be encrypted.
Encrypted urls always start with a "*". Use the program "scramble"
on your Dreambox to encrypt.
For almost each xml tag, it's possible to add a helptext.
If you ommit helptext, "Please select an item" is shown.
Example:
<category name="Downloads..." helptext="Download software">
For almost each xml tag, it's possible to close, restart or hide the PPanel afterwards.
Use quit="restart" to restart the PPanel again. This may be needed if the xml file of
the PPanel has been changed and must be reloaded, for example in "Download latest menu".
Use quit="exit" to exit the PPanel and return to the application which called the PPanel.
Use quit="hide" to hide the PPanel and show a small "press OK" button in the left top corner
of the screen. After pressing OK the PPanel will be shown again. This is very useful for <media>.
Example:
<execute name="Download latest menu"
condition="[ ! -f /var/etc/ppanelautodownload ]"
target="ppanelupdate.sh http://pli.dreamvcr.com/emerald/xml/dm7000/software.tar.gz /; rm -f /tmp/ppanelrefresh"
confirmation="Are you sure to download the latest menu?"
quit="restart"/>
For <directory>, <ppanel> and <category> it's possible to lock the screen using a PIN code.
The PIN code will be the one used in Setup/Parental Lock/Setup lock (if enabled).
Add lock="true" to lock your PPanel.
In this case download a google gif and store it in /tmp/logo.gif
Parameters:
name : name in screen, compulsory
url : download URL, compulsory
target : where to store the file, if not specified it defaults to "/dev/null"
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
url="http://www.google.nl/intl/nl_nl/images/logo.gif"
target="/tmp/logo.gif"
helptext="File will be stored in /tmp/logo.gif"/>
Note this can show picture as well play recorded movies, mp3 and even streaming mp3.
For streaming mp3 add: stream="true".
Parameters:
name : name in screen, compulsory
target : filename or download URL, both work, compulsory
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit,
stream (="true"), for m3u streams.
target="/share/tuxbox/enigma/htdocs/top.jpg"
helptext="Shows /share/tuxbox/enigma/htdocs/top.jpg"/>
target="http://www.gnu.org/graphics/gnu-head-sm.jpg"
helptext="Shows http://www.gnu.org/graphics/gnu-head-sm.jpg"/>
target="http://64.236.34.196:80/stream/1065" stream="true"
helptext="Plays http://64.236.34.196:80/stream/1065"/>
target="http://pli.dreamvcr.com/garnet/xml/all/pli_news.txt"
helptext="Show PLi news from internet"/>
target="/hdd/movie/mymove.ts"/>
target="/hdd/mp3/mymp3.mp3"/>
The use of <media> is recommended.
Parameters:
name : name in the screen, compulsory
target : program to execute, compulsory
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
target="ls /tmp"
helptext="Executes ls /tmp"/>
target="echo Here we go!; ls /tmp"
confirmation = "true"
helptext="Executes ls /tmp and some more"/>
Also supports ipkg packages
THIS IS FOR PLI INTERNAL USE ONLY
Parameters:
name : name in the screen, compulsory
url : download URL, compulsory
version : package version, optional
action : install action, optional, default is "upgrade"
packageType : one of "var" (default), "hdd" or "set", optional
package : short name of the package as shown in the uninstaller, optional
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
Note: If url is a directory in the filesystem, "manual install" will be opened.
<tarball name="Download and install something"
url="http://somewhere/something.tar.gz"
confirmation="true"/>
Parameters:
name : name in the screen, compulsory
Optional is : condition
Parameters:
name : name in the screen, compulsory
Optional is : condition, helptext
helptext="Show my installed plugins"/>
Parameters:
name : name in the screen, compulsory
target : plugin configuration file, compulsory
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
target="setup.cfg"
helptext="Open the PLi setup tool"/>
<ppanel> is basically the same as <category>. If "target" is omitted, <ppanel> will behave as <category>.
If a target is specified in <category>, it will behave as <ppanel>.
Parameters:
name : name in the screen, compulsory
target : filename of the ppanel, compulsory
Optional are : lock, confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
target="/var/etc/software.xml"
helptext="Show Software management"/>
THIS IS FOR PLI INTERNAL USE ONLY
Parameters:
name : name in the screen, compulsory
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
<remove name="Remove Software..."
confirmation="true"/>
Parameters:
Note that target must be prefixed by 'i:', 'u:', 'd:' or 's:'
<configwrite name="Enable two services"
target="i:/ezap/ci/handleTwoServices"
value="1"/>
Deletions:
{{googletranslate}}
Parameters:
name : name in screen, compulsory
Optional is : condition, lock
For almost each xml tag, it's possible to execute a script
before and after the action. These options are:
runBefore : run a program before, no output is shown
runAfter : run a program after, no output is shown
runBeforeOut : run a program before and show output
runAfterOut : run a program after and show output
Example:
<file name="Download a file from internet"
url="http://www.google.nl/intl/nl_nl/images/logo.gif"
target="/tmp/logo.gif"
runAfter="rm /tmp/logo.gif"/>
All four options can be used simultaneously
All xml tags except <directory> can have a script which is
evaluated runtime while the xml file is read. If the script
returns true the xml tag will be shown.
Example:
<execute name="Enable automatic menu downloads"
condition="[ ! -f /var/etc/ppanelautodownload ]"
target="touch /var/etc/ppanelautodownload; echo Automatic downloads enabled"/>
<execute name="Disable automatic menu downloads"
condition="[ -f /var/etc/ppanelautodownload ]"
target="rm -f /var/etc/ppanelautodownload; echo Automatic downloads disabled"/>
Depending on if /var/etc/ppanelautodownload exists, only one of the two is shown.
For almost each xml tag, it's possible to have a confirmation.
If you ommit confirmation, no confirmation will be asked.
If confirmation is "true", you will get a default confirmation.
Otherwise, the confirmation will be the text after confirmation.
Example:
<file name="Download a file from internet"
url="http://www.google.nl/intl/nl_nl/images/logo.gif"
target="/tmp/logo.gif"
confirmation="Do you have internet?"/>
The url option in <tarball>, <file>, <media> and <picture> can be encrypted.
Encrypted urls always start with a "*". Use the program "scramble"
on your Dreambox to encrypt.
For almost each xml tag, it's possible to add a helptext.
If you ommit helptext, "Please select an item" is shown.
Example:
<category name="Downloads..." helptext="Download software">
For almost each xml tag, it's possible to close, restart or hide the PPanel afterwards.
Use quit="restart" to restart the PPanel again. This may be needed if the xml file of
the PPanel has been changed and must be reloaded, for example in "Download latest menu".
Use quit="exit" to exit the PPanel and return to the application which called the PPanel.
Use quit="hide" to hide the PPanel and show a small "press OK" button in the left top corner
of the screen. After pressing OK the PPanel will be shown again. This is very useful for <media>.
Example:
<execute name="Download latest menu"
condition="[ ! -f /var/etc/ppanelautodownload ]"
target="ppanelupdate.sh http://pli.dreamvcr.com/emerald/xml/dm7000/software.tar.gz /; rm -f /tmp/ppanelrefresh"
confirmation="Are you sure to download the latest menu?"
quit="restart"/>
For <directory>, <ppanel> and <category> it's possible to lock the screen using a PIN code.
The PIN code will be the one used in Setup/Parental Lock/Setup lock (if enabled).
Add lock="true" to lock your PPanel.
In this case download a google gif and store it in /tmp/logo.gif
Parameters:
name : name in screen, compulsory
url : download URL, compulsory
target : where to store the file, if not specified it defaults to "/dev/null"
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
url="http://www.google.nl/intl/nl_nl/images/logo.gif"
target="/tmp/logo.gif"
helptext="File will be stored in /tmp/logo.gif"/>
Note this can show picture as well play recorded movies, mp3 and even streaming mp3.
For streaming mp3 add: stream="true".
Parameters:
name : name in screen, compulsory
target : filename or download URL, both work, compulsory
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit,
stream (="true"), for m3u streams.
target="/share/tuxbox/enigma/htdocs/top.jpg"
helptext="Shows /share/tuxbox/enigma/htdocs/top.jpg"/>
target="http://www.gnu.org/graphics/gnu-head-sm.jpg"
helptext="Shows http://www.gnu.org/graphics/gnu-head-sm.jpg"/>
target="http://64.236.34.196:80/stream/1065" stream="true"
helptext="Plays http://64.236.34.196:80/stream/1065"/>
target="http://pli.dreamvcr.com/garnet/xml/all/pli_news.txt"
helptext="Show PLi news from internet"/>
target="/hdd/movie/mymove.ts"/>
target="/hdd/mp3/mymp3.mp3"/>
The use of <media> is recommended.
Parameters:
name : name in the screen, compulsory
target : program to execute, compulsory
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
target="ls /tmp"
helptext="Executes ls /tmp"/>
target="echo Here we go!; ls /tmp"
confirmation = "true"
helptext="Executes ls /tmp and some more"/>
Also supports ipkg packages
THIS IS FOR PLI INTERNAL USE ONLY
Parameters:
name : name in the screen, compulsory
url : download URL, compulsory
version : package version, optional
action : install action, optional, default is "upgrade"
packageType : one of "var" (default), "hdd" or "set", optional
package : short name of the package as shown in the uninstaller, optional
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
Note: If url is a directory in the filesystem, "manual install" will be opened.
<tarball name="Download and install something"
url="http://somewhere/something.tar.gz"
confirmation="true"/>
Parameters:
name : name in the screen, compulsory
Optional is : condition
Parameters:
name : name in the screen, compulsory
Optional is : condition, helptext
helptext="Show my installed plugins"/>
Parameters:
name : name in the screen, compulsory
target : plugin configuration file, compulsory
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
target="setup.cfg"
helptext="Open the PLi setup tool"/>
<ppanel> is basically the same as <category>. If "target" is omitted, <ppanel> will behave as <category>.
If a target is specified in <category>, it will behave as <ppanel>.
Parameters:
name : name in the screen, compulsory
target : filename of the ppanel, compulsory
Optional are : lock, confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
target="/var/etc/software.xml"
helptext="Show Software management"/>
THIS IS FOR PLI INTERNAL USE ONLY
Parameters:
name : name in the screen, compulsory
Optional are : confirmation, runBefore, runAfter, runBeforeOut, runAfterOut, condition, helptext, quit
<remove name="Remove Software..."
confirmation="true"/>
Parameters:
Note that target must be prefixed by 'i:', 'u:', 'd:' or 's:'
<configwrite name="Enable two services"
target="i:/ezap/ci/handleTwoServices"
value="1"/>


Revision [4282]

Edited on 2011-09-09 16:51:51 by rokco [Fixed UTF-8 issues]
Additions:
Please be informed that PPanel is only fully implemented on Enigma1. Enigma2 has only a subset of below mentioned features.
[[http://www.pli-images.org/forum/viewthread.php?forum_id=65&thread_id=19497&pid=212852#post_212852 Forum post]]


Revision [4113]

Edited on 2011-01-12 11:15:24 by MiLo [modified ppanel directory location]
Additions:
* PPanel can read other XML files via
* enigma1: /var/etc/ppanels/
* enigma2: /etc/ppanels/ for system panels (typically as part of plugins)
* enigma2: /etc/enigma2/ppanels/ for user-defined panels (to be included in backup)
Deletions:
* PPanel can read other XML files via /var/etc/ppanels


Revision [2739]

Edited on 2008-07-30 02:04:22 by jonc [Pli(r) change]
Additions:
===={{color c="gray" text="PLi® development tools for you to use"}}====
Deletions:
===={{color c="gray" text="Pli development tools for you to use"}}====


Revision [2733]

Edited on 2008-07-30 01:53:28 by jonc [Pli(r) change]
Additions:
====PPanel Power!====
Deletions:
===PPanel Power!===


Revision [2731]

Edited on 2008-07-30 01:49:40 by jonc [Pli(r) change]
Additions:
===={{color c="gray" text="Pli development tools for you to use"}}====
Deletions:
[[HomePage PLi® Wiki HomePage]]


Revision [2730]

Edited on 2008-07-30 01:43:48 by jonc [Google gadget added + menu & footers]
Additions:
{{googletranslate}}
[[HomePage PLi® Wiki HomePage]] : [[DM500 DM500]] : [[DM500plus DM500+]] : [[DM56xx DM56xx]] : [[DM600 DM600]] : [[DM7000 DM7000]] : [[DM7020 DM7020]] : [[DM7025 DM7025]] : [[DM800 DM800]]


Revision [508]

The oldest known version of this page was created on 2008-05-31 11:48:25 by jonc [Google gadget added + menu & footers]
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki