If you like BoxMatrix then please contribute Supportdata, Supportdata2, Firmware and/or Hardware (get in touch).
My metamonk@yahoo.com is not reachable by me since years. Please use hippie2000@webnmail.de instead.

HTML-Text

From BoxMatrix


BoxMatrix >> Webinterface >> HTML-Text @ BoxMatrix   -   IRC-Chat   -   Translate: de es fr it nl pl
News Selectors Models Accessories Components Environment Config Commands System Webif Software Develop Lexicon Community Project Media

UI-Structure UI-Modules HTML-Files XML-Files REST-API Lua-Scripts Javascript Browser SSI-Files SSI-Directives HTML-Text Event-Text Help-Pages CSS-Files Graphics Research

Info
Initially AVM only sold the FRITZ!Box in Germany (Annex B), then in the german speaking countries Austria and Switzerland (Annex A). 2 firmwares just differing in Annex DSL firmware and one common language for the Webinterface were easy to maintain. When they opened for the international market they added 2 further firmwares, both with english Webinterface. Different techniques were used to maintain these 2 languages. For models up to 7270v1 there was not enough space in flash to store both Annex firmwares and the Webinterface for 2 languages.

This situation changed with generation 7270v2+ with more flash, when AVM started with CONFIG_DSL_MULTI_ANNEX and CONFIG_MULTI_LANGUAGE in firmware 4.63. They started with 5 languages (today we have 7), and to simplify the maintenance they decided to have a common static Webinterface with interchangable translated text snippets, which are inserted using SSI. The idea of HTML-Text databases per language was born.


HTML-Text[edit]

HTML-Text is stored in the 7 databases htmltext_de.db, htmltext_en.db, htmltext_es.db, htmltext_fr.db, htmltext_it.db, htmltext_nl.db and htmltext_pl.db with a common static symlink htmltext.db pointing to a link in RAM which points to the respective db of the current language. This link is created in rc.conf according to the Language variable and can be changed using the setlanguage command. htmltext.db is used by libtiinterpreter.so, which does all the SSI stuff. HTML-Text can be included in all textual formats which are served by the AVM webserver by special SSI-Directives using the form {? ... ?}. They can either be textual keys like {?gTxtFritzBox?} or numerical keys made of 2 colon separated numbers like {?2:3?}.

Goto:   Textual-Keys   -   Numerical-Keys   -   Variable-Expansion

Textual-Keys[edit]

Textual keys are used since firmware 4.63, which introduced htmltext.db. Starting with firmware 4.88 AVM added numerical keys
for the longer strings like explananations (see the second table), keeping textual keys for shorter text snippets like Continue of Cancel
button texts or menu entries like Overview or Telephony

Daily updated index of all textual keys found scanning Firmware-Probes . Last update: 2024-04-06 08:31 GMT.
The label (dbtext) in the Text-Key column shows there are other objects in this wiki using this name.
The Mod column shows the amount of models using the respective key. Click the column header to sort by this number.

Goto:   A - B - C - D - E - F - G - H - I - J - K - L - M - N - O - P - Q - R - S - T - U - V - W - X - Y - Z   -   Index

Numerical-Keys[edit]

Numerical keys are used since firmware 4.88 and are made of 2 colon separated numbers like {?2:3?}.
The first number ranges from 0 to nearly 9999 and describes the topic of a range of strings, typically used for one page.
If more than one page is listed in the Usage column then this may be a conflict across firmware versions. See the Model-Matrix then.
The second number describes a string within this topic. Both number so nort have a sequential order, so there are a lot of gaps.
The following table lists the relation of a topic number to the amuunt of strings within each topics, there may be several hundreds.
Since Wiki articles with numerical names are difficult to handle and collide with model nick names the topic numbers are named ntext_* (numerical text key) here.

Daily updated index of all numerical keys found scanning Firmware-Probes . Last update: 2024-04-06 08:32 GMT.
The label (dbtext) in the Topic-Key column shows there are other objects in this wiki using this name.
The Mod column shows the amount of models using the respective key. Click the column header to sort by this number.

Variable-Expansion[edit]

HTML-Text from htmltext.db can be arbitrary strings, like all SSI stuff. They may contain a special set of variables, or even code depending on where they are inserted.

Inserting a passed value:

Unspecified error (code = %1) occurred.

Inserting the variables lowport and highport:

Enter a port between  %1%lowport% and %2%highport%

HTML-Text is also used for language sensitive Push-Mail with custom variables which appear like shell expansion of the Config-Environment, but use a separate pseudo environment
handled by libmailbuilder.so, which is (optionally) opened by libcmapi.so for ctlmgr:

Your ${CONFIG_PRODUKT_NAME_SHORT} is still using FRITZ!OS version ${FWUPDATE_STATUS_FROM_VERSION}.

Double quotes in HTML-Text are escaped using a backslash, like \".

Fact-Box