====================================================
Menu Fantastic for Dreambox 7025 
Field Test Version 0.1.1 by gutemine from 3.3.2007
====================================================
Release infos 
====================================================
0.0.7 first  public Field Test Version
0.0.8 second public Field Test version
      A: R: Options, scripts and binaries can now
      have absolute path
0.0.9 support for SHIFT + Colour Buttons 
      L: option for Logging, I:  option now can 
      display file content, Y: now supports different 
      menu for yes/No
0.1.0 support for plugins from Games/Extensions
      with P: option
0.1.1 Support for LCD only output with D: option
====================================================
The English Documentation is below the German one 
====================================================

1) Voraussetzung
----------------

Jedes aktuelle Image sollte mit dem Menu Fantastic Plugin
funktionieren. 

2) Installation
---------------

Zuerst kopiert das 
enigma2-plugin-extensions-fantastic*.ipk File 
vom enigma2-plugin-extensions-fantastic*.zip auf 
/tmp mit ftp (TCP/IP muss natrlich schon 
funktionieren). 

Wenn Ihr ein Image geflashed habt, das ein Blue 
Pannel hat knnt Ihr damit mit Manual Install das
ipk file installieren.

Wenn nicht, dann installiert Menu Fantastic 
mit folgenden Kommandos im Telnet:

cd /
ipkg install /tmp/enigma2-plugin-extensions-fantastic*.ipk

Beim ipk install wird enigma auch gleich 
restarted, um das Menu Fantastic Plugin bei den 
Spielen/Erweiterungen angezeigt zu bekommen. 
Wenn es dort nicht auftaucht, 
probieren Sie einen manuellen Reboot.

3) Verwendung
-------------

Menu Fantastic ist ein generisches Menu Plugin
fr Enigma2 auf der DMM 7025. 

Die Menus werden vllig frei ber *.cfg files
Konfiguriert, hier als Beispiel die main.cfg:

S:main:Menu Fantastic Main Menu:startup.sh
E:main:Execute Shell in Background:shell1.sh
C:main:Execute Shell in Window:shell2.sh
I:main:Show Info Message:this is the info message
I:main:Show Info Message with timeout:infomessage with timeout 20 sec:20
M:newmenu:Show New Menu
Y:newmenu:Show New Menu with question Y/N:noemnue
T:newmenu:Show New Menu with Enter Text
T:newmenu:Show New Menu with Enter Text with default:defaulttext
L:newmenu:Log ausgeben:logtext:log

Die syntax ist immer wie folgt:

Kommando:cfg filename ohne cfg:Menu Bezeichnung:Aktion: Option 

Mgliche Kommandos sind wie in obigem Beispiel:

S: Startup Kommando ist ein Shell script und 
   wird immer beim aufruf des Menu ausgefhrt, sowie definiert 
   den Menu Namen. Ausnahme das Mainmenu (heisst immerm ain.cfg), 
   dessen script wird beim Starten
   von enigma2 ausgefhrt, und kann daher auch benutzt werden
   um Sachen beim booten des Images auszufhren.

E: Ausfhren eines scripts im Hintergrund

C: Ausfhren eines Skipts in Consolefenster vom enigma2,
   so dass man output sieht

I: Ausgeben einer Infomessage (optional mit :timeout in sekunden)
   wobei wenn im Plugin directory oder auf /tmp ein File mit
   dem infotext.txt besteht wird dessen 1.Zeile ausgegeben.

D: Ausgeben einer Infomessage nur auf LCD 

M: Aufrufen eines neuen Menus

Y: Aufrufen eines Menus mit Y/N Frage - je nach der Antwort
   wird das menu von vorne oder hinten bei den optionen angezeigt

T: Texteingabe, Text wird als argument dem Startup script des Menus
   bergeben (optional mit :default text)

R: Restart Option
   mit :1 (Deepstandby) :2 (Reboot) :3 (Enigma2 restart) als Parameter

A: Applikationscontainer - LCD, Framebuffer und Fernbedienung werden 
   vom Enigma2 freigegeben, TV gestoppt

L: Logging option zum ausgeben von text in ein log.
   Mgliche optionen sind wall, log, logappend oder gar nichts 
   dann geht es nur zum consolelog vom enigma2. Das logfile
   liegt auf /tmp/fantasticlog.txt

P: damit kann man Plugins die normalerweise nur ber Spiele/Erweiterungen
   aufrufbar sind von Menu Fantastic aus direkt aufrufen. 
   Als Option gibt man den Directory Namen des Plugins in 
   Plugins/Extensions oder Plugins/SystemPlugins an.

Neben einem einfachen main.cfg sind noch 2 Beispiel 
newmenu*.cfg enthalten und eine red.cfg fr SHIFT und dann
die Farbtaste, sowie ein 
paar kleine Shell scripts die mit wall und echo 
anzeigen dass (und mit welchen Argumenten) sie 
aufgerufen wurden.

All diese Files sind im plugin directory:

/usr/lib/enigma2/python/Plugins/Extensions/Fantastic

Die eigentliche Applikations Logik knnt/msst Ihr dann in 
Shell scripten, python skripten, etc. machen. Menu Fantastic
erspart Euch aber das mhsame Programmieren der Python Menus
fr deren Aufruf aus Enigma2 !

Das Menu fantastic Plugin ist immer noch im Fieldtest,
es kann sich also die Syntax der Menu Files durchaus 
noch ndern, aber das ist die Idee hinter einem Fieldtest
das es so implementiert wird wie Ihr es haben wollt !

====================================================
Viel Spass mit dem Menu Fantastic Plugin 
auf der Dreambox 7025 !!!!
====================================================


1) Prerequisites
----------------

Any current Image should work with the Menu Fantastic Plugin.

2) Installation
---------------

First copy the enigma2-plugin-extensions-fantastic*.ipk 
File from the enigma2-plugin-extensions-fantastic*.zip 
to /tmp with ftp (TCP/IP must be working already). 

If you have flashed an image that offer in Blue 
Pannel Manual Addon Install you can use this 
functionality to install the ipk file.

If not, then install Menu Fantastic by entering the 
following commands in a Telnet session:

cd /
ipkg install /tmp/enigma2-plugin-extensions-fantastic*.ipk

The ipkg install will also restart enigma for 
you to get the Menu Fantastic Plugin shown in addons 
menu. If it doesn't show up try to reboot 
manually.

3) Usage
--------

Menu Fantastic is a generic Menu Plugin
for Enigma2 on the DMM 7025. 

The Menus ware completely free defined/configured 
via *.cfg files, here as an example the included
main.cfg:

S:main:Menu Fantastic Main Menu:startup.sh
E:main:Execute Shell in Background:shell1.sh
C:main:Execute Shell in Window:shell2.sh
I:main:Show Info Message:this is the info message
I:main:Show Info Message with timeout:infomessage with timeout 20 sec:20
M:newmenu:Show New Menu
Y:newmenu:Show New Menu with question Y/N:nomenu
T:newmenu:Show New Menu with Enter Text
T:newmenu:Show New Menu with Enter Text with default:defaulttext
L:newmneu:Show Log:logtext:log

The syntax is always as follows:

Command:cfg filename without cfg:Menu Label:action:option 

Possible Commands are as in the above example:

S: Startup Command is a Shell script and will
   be executed on startup of the menu and it defines
   the menuname. Exception is the Mainmenu (which
   has to be named main.cfg), this script will be
   executed on Startup of enigma2 and hence can be 
   used to execute things when booting.

E: Execute of a script in background

C: Execute of a script in a console windows of enigma2
   so that the output is displayed.

I: Display of an Infomessage (optional with :timeout in seconds)
   If a file named infotext.txt at /tmp or the plugin
   directory it's first line will be displayed.

D: Display of an Infomessage on LCD only

M: Open of a new Menu

Y: Open of a Menu with Y/N Question. Drpending on anser the menu
   from th beginning or ptions is shown 

T: Textentry, Text is passed as argument to the Startup script
   of the Menus (optional with :default text)

R: Restart Option
   with :1 (Deepstandby) :2 (Reboot) :3 (Enigma2 restart) as parameter

A: Applicationcontainer - LCD, Framebuffer and Remote Control 
   are released by Enigma2 and TV is stopped.

L: Logging option for passing text to a log.
   Possible options are wall, log, logappend or no option,
   the output goes to the consolelog of enigma2. The logfile
   is at /tmp/fantasticlog.txt

P: With this you can call Plugins which are normaly only
   available via Games/Extensions.
   As Option you pass the directory name of the Plugins in 
   Plugins/Extensions or Plugins/SystemPlugins.


Besides a simple main.cfg there are 2 sample newmenu*.cfg 
included and a red.cfg for showing the SHIFT + Red button support
as an example, and a few small shell scripts which show with
wall and echo that they were called (and with what arguments)

All these files reside in the plugin directory:

/usr/lib/enigma2/python/Plugins/Extensions/Fantastic

The real application logic needs to be done in shell scripts, 
python scripts, etc. Menu Fantastic only relieves you from
the programming of the python menus and the call of the 
scripts from enigma2 !

Menu Fantastic Plugin is still in Field test, 
so the syntax of the menu files
and their behaviour is vulnerable to changes, but this is
the idea of a Field Test, that it can be implemented the
way the users want it !

======================================================
Have Fun with the Menu Fantastic Plugin on
your Dreambox 7025 !!!!
======================================================
