Wizd Skin HOWTO
Wizd skins are composed of the following files:
For details view, with one line per file
head.html
line_*.html (repeated for each file)
tail.html
For thumbnail view, with rows and columns
thumb_head.html
thumb_*.html (repeated for each file in the row)
thumb_row.html (between each row)
thumb_*.html (repeated for each file in the next row)
thumb_tail.html
The "*" in the filenames is one of the following:
| chapter |
chapters on DVD chapter view |
| delete |
Used for all files in delete mode |
| dir |
directories |
| document |
Used for text or html files |
| image |
Image files, other than JPEG |
| iso |
ISO and IMG dvd images |
| jpeg |
JPEG image files |
| movie |
All movie files |
| music |
All music files |
| musiclist |
Music playlist files (typically the same as "music") |
| playlist |
Video playlist files (typically the same as "video") |
| svi |
??? |
| pseudo |
??? |
| unknown |
Used for any files which don't match anything else, and as a default if the desired skin file is missing |
| url |
Used for internet shortcut files from Internet Explorer |
wizd_skin.conf
The skin directory should contain a configuration file which defines
the number of lines per page for "details" view, and the number of rows
and columns for "thumbnail" view. In addition it defines the
maximum width of the limited-length file names used in the display.
The "menu_icon_type" defines the default file extension for the
automatic icon name generation use by the WIZD_INSERT_LINE_FILE_IMAGE
keyword.
page_line_max 18
menu_filename_length_max 75
thumb_row_max 5
thumb_column_max 6
thumb_filename_length_max 24
menu_icon_type gif
WIZD_INSERT_LINE_FILE_IMAGE
This keyword is a special function which returns an appropriate link
for a thumbnail image for the file. For jpeg and image files it
will return a link to the file. For directories, video, and music
files, it will look for a matching thumbnail image from the following
list:, where "%s" is replaced with the base filename of the file
(without the original extension).
tn_%s.jpg
tn_%s.png
tn_%s.gif
%s.jpg
%s.png
%s.gif
%s/Folder.jpg
%s/AlbumArtSmall.jpg
If none of these match an existing thumbnail file, then a generic
default skin icon is used. For details mode, this will be
"icon_*.gif" where the "*" is replaced with the file type (just like
the line_*.html and thumb_*.html files) and the "gif" is defined
by the menu_icon_type defined in the wizd_skin.conf file.
For thumbnail mode, this will be "thumb_*.gif".
These keywords give global server information
<!--WIZD_INSERT_SERVER_ADDRESS-->
<!--WIZD_INSERT_SERVER_NAME-->
<!--WIZD_INSERT_CURRENT_DATE-->
<!--WIZD_INSERT_CURRENT_TIME-->
These keywords give information about the current directory
Insert full path to the current directory
<!--WIZD_INSERT_CURRENT_PATH-->
Insert the name of the current directory
<!--WIZD_INSERT_CURRENT_DIR_NAME-->
Insert URL link to the parent directory
<!--WIZD_INSERT_PARENT_DIR_LINK-->
Insert the name of the parent directory
<!--WIZD_INSERT_PARENT_DIR_NANE--> (yes, this is spelled NANE)
Insert URL to the current page
<!--WIZD_INSERT_CURRENT_PATH_LINK-->
Insert absolute URL to the current page, including http://servername:port
<!--WIZD_INSERT_CURRENT_PATH_FULL_LINK-->
Insert URL to the current page, omitting any param= part
<!--WIZD_INSERT_CURRENT_PATH_LINK_NO_PARAM-->
Insert URL to the current page, omitting any sort= part
<!--WIZD_INSERT_CURRENT_PATH_LINK_NO_SORT-->
Insert URL to the current page, omitting any dvdopt= part
<!--WIZD_INSERT_CURRENT_PATH_LINK_NO_DVDOPT-->
Insert URL to the current page, omitting any option= part
<!--WIZD_INSERT_CURRENT_PATH_LINK_NO_OPTION-->
Insert page number information for this page and menu
<!--WIZD_INSERT_CURRENT_PAGE-->
<!--WIZD_INSERT_MAX_PAGE-->
<!--WIZD_INSERT_NEXT_PAGE-->
<!--WIZD_INSERT_PREV_PAGE-->
<!--WIZD_INSERT_FILE_NUM-->
<!--WIZD_INSERT_START_FILE_NUM-->
<!--WIZD_INSERT_END_FILE_NUM-->
Use BODY function onloadset="<!--WIZD_INSERT_ONLOADSET_FOCUS-->"
where focus is L1, or L2, or L3, ... to select one of these lines on
the page. Use <A
NAME="L<!--WIZD_INSERT_LINE_TVID-->"> to set the tag names
<!--WIZD_INSERT_ONLOADSET_FOCUS-->
<!--WIZD_INSERT_CLIENT_CHARSET-->
Insert link to the default photo playlist for this directory, or the global default if there is no local default
<!--WIZD_INSERT_DEFAULT_PHOTOLIST-->
Insert link to the default music playlist for this directory, or the global default if there is no local default
<!--WIZD_INSERT_DEFAULT_MUSICLIST-->
Put this at the end of the menu (tail.html) to insert hidden URL links to secret directories
<!--WIZD_INSERT_SECRET_DIR_LINK-->
The following keyword pairs start/end sections which are conditionally included
Remove this section if this is the root (top level) directory
<!--WIZD_DELETE_IS_ROOTDIR-->
<!--/WIZD_DELETE_IS_ROOTDIR-->
Remove this section if this is the first page of the menu
<!--WIZD_DELETE_IS_NO_PAGE_PREV-->
<!--/WIZD_DELETE_IS_NO_PAGE_PREV-->
Remove this section if this is the last page of the menu
<!--WIZD_DELETE_IS_NO_PAGE_NEXT-->
<!--/WIZD_DELETE_IS_NO_PAGE_NEXT-->
Remove this section if there are no movie files in the directory
<!--WIZD_DELETE_IS_NO_STREAM_FILES-->
<!--/WIZD_DELETE_IS_NO_STREAM_FILES-->
Remove this section if there are no music files in the directory
<!--WIZD_DELETE_IS_NO_MUSIC_FILES-->
<!--/WIZD_DELETE_IS_NO_MUSIC_FILES-->
Remove this section if there are no photo files in the directory
<!--WIZD_DELETE_IS_NO_PHOTO_FILES-->
<!--/WIZD_DELETE_IS_NO_PHOTO_FILES-->
Include this section only if file delete option is enabled in the server
<!--WIZD_CAN_DELETE-->
<!--/WIZD_CAN_DELETE-->
Include this section of there is a previous page
<!--WIZD_IF_PAGE_PREV-->
<!--/WIZD_IF_PAGE_PREV-->
Include this section if there is a following page
<!--WIZD_IF_PAGE_NEXT-->
<!--/WIZD_IF_PAGE_NEXT-->
Include this section if video files exist in the current directory
<!--WIZD_IF_STREAM_FILES-->
<!--/WIZD_IF_STREAM_FILES-->
Include this section if music files exist in the current directory
<!--WIZD_IF_MUSIC_FILES-->
<!--/WIZD_IF_MUSIC_FILES-->
Include this section if photo files exist in the current directory
<!--WIZD_IF_PHOTO_FILES-->
<!--/WIZD_IF_PHOTO_FILES-->
Include this section if this is the first page of the menu
<!--WIZD_IF_NO_PAGE_PREV-->
<!--/WIZD_IF_NO_PAGE_PREV-->
Include this section of this is the last page of the menu
<!--WIZD_IF_NO_PAGE_NEXT-->
<!--/WIZD_IF_NO_PAGE_NEXT-->
Include this section only if there are no video files in the directory
<!--WIZD_IF_NO_STREAM_FILES-->
<!--/WIZD_IF_NO_STREAM_FILES-->
Include this section only if there are no music files in the directory
<!--WIZD_IF_NO_MUSIC_FILES-->
<!--/WIZD_IF_NO_MUSIC_FILES-->
Include this section only if there are no music files in the directory
<!--WIZD_IF_NO_PHOTO_FILES-->
<!--/WIZD_IF_NO_PHOTO_FILES-->
Include this section only if MP3 tags exist
<!--WIZD_DELETE_IS_NO_MP3_TAGS-->
<!--/WIZD_DELETE_IS_NO_MP3_TAGS-->
Delete this section if MP3 tags exist
<!--WIZD_DELETE_IS_HAVE_MP3_TAGS-->
<!--/WIZD_DELETE_IS_HAVE_MP3_TAGS-->
Include this section if the menu line number is even
<!--WIZD_IF_LINE_IS_EVEN-->
<!--/WIZD_IF_LINE_IS_EVEN-->
Include this section if the menu line number is even
<!--WIZD_IF_LINE_IS_ODD-->
<!--/WIZD_IF_LINE_IS_ODD-->
Delete this section if the client is a PC
<!--WIZD_IF_CLIENT_IS_NOT_PC-->
<!--/WIZD_IF_CLIENT_IS_NOT_PC-->
Include this section if the client is a PC
<!--WIZD_IF_CLIENT_IS_PC-->
<!--/WIZD_IF_CLIENT_IS_PC-->
Include this section if the client is using HD resolution
<!--WIZD_IF_CLIENT_IS_HD-->
<!--/WIZD_IF_CLIENT_IS_HD-->
Delete this section if the client is using HD resolution
<!--WIZD_IF_CLIENT_IS_NOT_HD-->
<!--/WIZD_IF_CLIENT_IS_NOT_HD-->
Include this section of the desired focus line is not defined
<!--WIZD_IF_FOCUS_IS_NOT_SPECIFIED-->
<!--/WIZD_IF_FOCUS_IS_NOT_SPECIFIED-->
Include this section of there is a desired focus line
<!--WIZD_IF_FOCUS_IS_SPECIFIED-->
<!--/WIZD_IF_FOCUS_IS_SPECIFIED-->
<!--WIZD_INSERT_DVD_OPTIONS-->
Information used in the line_*.html and thumb_*.html files
Full file name, including extension (length limited to the skin's maximum filename length)
<!--WIZD_INSERT_LINE_FILE_NAME-->
Full file name, without extension (length limited to the skin's maximum filename length)
<!--WIZD_INSERT_LINE_FILE_NAME_NO_EXT-->
Just the file's extension (mp3, avi, mpg, etc)
<!--WIZD_INSERT_LINE_FILE_EXT-->
URL link to play this file
<!--WIZD_INSERT_LINE_FILE_LINK-->
URL link to view chapter information for this file (DVD video only)
<!--WIZD_INSERT_LINE_CHAPTER_LINK-->
Information about chapters in this file (DVD video only)
<!--WIZD_INSERT_LINE_CHAPTER_STR-->
Thumbnail image for this file
<!--WIZD_INSERT_LINE_FILE_IMAGE-->
<!--WIZD_INSERT_LINE_TIMESTAMP--> (YYYY/MM/DD HH:MM)
<!--WIZD_INSERT_LINE_FILE_DATE--> (YYYY/MM/DD)
<!--WIZD_INSERT_LINE_FILE_TIME--> (HH:MM)
<!--WIZD_INSERT_LINE_FILE_DURATION--> (HH:MM)
<!--WIZD_INSERT_LINE_FILE_SIZE-->
Column and row number on this screen of the menu
<!--WIZD_INSERT_LINE_COLUMN_NUM-->
<!--WIZD_INSERT_LINE_ROW_NUM-->
Insert the file number, used for remote-control selection
<!--WIZD_INSERT_LINE_TVID-->
Insert string vod="playlist" or vod="0" as required to play video files
<!--WIZD_INSERT_LINE_FILE_VOD-->
Information about SVI files
<!--WIZD_INSERT_LINE_SVI_INFO-->
<!--WIZD_INSERT_LINE_SVI_REC_TIME-->
Size information for image files (jpg, gif, png)
<!--WIZD_INSERT_LINE_IMAGE_WIDTH-->
<!--WIZD_INSERT_LINE_IMAGE_HEIGHT-->
Insert tag information for MP3 files
<!--WIZD_INSERT_LINE_MP3TAG_TITLE-->
<!--WIZD_INSERT_LINE_MP3TAG_ALBUM-->
<!--WIZD_INSERT_LINE_MP3TAG_ARTIST-->
<!--WIZD_INSERT_LINE_MP3TAG_YEAR-->
<!--WIZD_INSERT_LINE_MP3TAG_COMMENT-->
Limited length copy of the MP3 song title
<!--WIZD_INSERT_LINE_MP3TAG_TITLE_INFO-->
AVI file tags
<!--WIZD_INSERT_LINE_AVI_FPS-->
<!--WIZD_INSERT_LINE_AVI_DURATION-->
<!--WIZD_INSERT_LINE_AVI_VCODEC-->
<!--WIZD_INSERT_LINE_AVI_ACODEC-->
<!--WIZD_INSERT_LINE_AVI_HVCODEC-->
<!--WIZD_INSERT_LINE_AVI_HACODEC-->
<!--WIZD_INSERT_LINE_AVI_IS_INTERLEAVED-->
Keywords for image_viewer.html
<!--WIZD_INSERT_IMAGE_VIEWER_WIDTH-->
<!--WIZD_INSERT_IMAGE_VIEWER_HEIGHT-->
<!--WIZD_INSERT_IMAGE_VIEWER_MODE-->
<!--WIZD_DELETE_IS_FIT_MODE-->
<!--/WIZD_DELETE_IS_FIT_MODE-->
<!--WIZD_DELETE_IS_NO_FIT_MODE-->
<!--/WIZD_DELETE_IS_NO_FIT_MODE-->