Search
PivotX Extensions
Categories
- Announcements
[3 entries, 1 comments] - Pivotx Extensions News
[12 entries, 1 comments]
- Total Entries: 15
- Total Comments: 2
Tag Cloud
Last Comments
- May 01 at 19:24
Geoffrey wrote (Useragent Info in…)
Archives
Creating Useragent in Comments Themes
23:04
how to do it
Creating themes for the extension couldn't be easier, though it can be time-consuming. It's as easy as creating a few images and a text file and placing them in a directory (which will then go in the /themes directory of the extension. It can be time-consuming as there are over 80 images that can be created.
Themes require three files—two images and one text file:
File Type | File Name | Information |
Unknown OS/Browser | unknown.png | If the translation routine does not recognize an operating system or browser from the useragent string, it will display this image. |
Missing | missing.png | If your theme is missing the image it needs to display, it will display this image instead (unless configured otherwise; see below). |
Theme Information | theme.txt | This file contains information pertinent to the theme, such as the theme's name, creator, and image dimensions. Contents are placed in the file as such: |
Name: Default in Grayscale Key: grayscale Creator: Geoffrey A. Wagner (Stingray) Email: geoffrey@mobius-design.net Date: 2011-06-25 Image: 14x14 Missing: theme
This is explained:
Title | Description |
Name required | The name of the theme. This information will be displayed in the extension's configuration for a user to select a theme. |
Key required | The internal name of the theme; it cannot contain spaces. This information must be the same as the directory name that all of the theme files are placed in. |
Creator: optional | Your name or however you would like to be recognized as the theme's creator |
Email: optional | Your email address |
Date: optional | The date the theme was created and updated. |
Image: semi-optional | The dimension of the images for your theme; width by height. This line is optional, and if it is missing, the extension will size your images to 14x14; so, if the images in your theme are of a different dimension, especially if they are not square, then it is best to include this line in your theme.txt file. |
Missing: semi-optional | If this line is set to "default", it will show the default theme's image for an image that is missing from your theme. Set it to anything else (or leave the line out entirely) to have the extension show your "missing.png" file for such an image. This setting does not negate the required "missing.png" image file. |
These lines do not need to be in this order; they can be in any order you would like.
You are, of course, free to add more information using the same format. At the moment, the extension doesn't do anything with the optional lines or any other information you might want to place in the file, but it may some time later.
Next are the images that can be displayed by the extension—the point of the extension. With database version 20200404.0906, there are 143 images that can be created to represent the information from a useragent as it is initially parsed (some images will be changed as the parsing continues, see below). If any of these images are missing, they will be replaced by your "missing.png" image or the default image stretched or shrunk to your theme's image dimension, based on the "Missing:" line in your "theme.txt" file. These images are as follows:
Supported OS | Image Name | For More Information |
Android | android.png | link |
Apple iPad | ipad.png | link |
Apple iPhone | iphone.png | link |
Arch Linux | archlinux.png | link |
BeOS/Zeta-OS | beos.png | link |
BlackBerry | blackberry.png | link |
CentOS Linux | centos.png | link |
Chromium OS | chromium.png | link |
Debian Linux | debian.png | link |
DragonflyBSD | dragonflybsd.png | link |
Edubuntu Linux | edubuntu.png | link |
Fedora Linux | fedora.png | link |
FreeBSD | freebsd.png | link |
Gentoo Linux | gentoo.png | link |
Haiku | haiku.png | link |
Kanotix Linux | kanotix.png | link |
Kindle Fire | amazonkindlefire.png | link |
Kubuntu Linux | kubuntu.png | link |
Linux Mint | mint.png | link |
Mac OS X | macosx.png | link |
Mac OS X El Capitan | macosx.png | link |
Mac OS X Leopard | macosx.png | link |
Mac OS X Lion | macosx.png | link |
Mac OS X Mavericks | macosx.png | link |
Mac OS X Mountain Lion | macosx.png | link |
Mac OS X Panther | macosx.png | link |
Mac OS X Snow Leopard | macosx.png | link |
Mac OS X Tiger | macosx.png | link |
Mac OS X Yosemite | macosx.png | link |
Macintosh | mac.png | link |
Mandriva Linux | mandriva.png | link |
MorphOS | morphos.png | link |
NetBSD | netbsd.png | link |
Nintendo 3DS | 3ds.png | link |
Nintendo DS | ds.png | link |
Nintendo DSi | dsi.png | link |
Nintendo Wii | wii.png | link |
Nintendo WiiU | wiiu.png | link |
OpenBSD | openbsd.png | link |
PCLinuxOS | pclinuxos.png | link |
PalmOS | palmos.png | link |
PlayStation 3 | ps3.png | link |
PlayStation 4 | ps4.png | link |
PlayStation Portable | psp.png | link |
PlayStation Vita | psvita.png | link |
Raspberry Pi | raspberrypi.png | link |
RedHat Linux | redhat.png | link |
SUSE Linux | suse.png | link |
Slackware Linux | slackware.png | link |
Sun Solaris | solaris.png | link |
Symbian OS | symbian.png | link |
Ubuntu Linux | ubuntu.png | link |
Ubuntu Linux - Budgie | ubuntubudgie.png | link |
Unspecified Linux | linux.png | link |
Unspecified Windows | windows.png | link |
Windows 10 | win10.png | link |
Windows 2000 | win2k.png | link |
Windows 3.x | windows3x.png | link |
Windows 7 | win7.png | link |
Windows 8 | win8.png | link |
Windows 8.1 | win8.png | link |
Windows 95 | win95.png | link |
Windows 98 | win98.png | link |
Windows CE/Pocket PC | wince.png | link |
Windows Millennium Edition | winme.png | link |
Windows Mobile | winmobile.png | link |
Windows NT | winnt.png | link |
Windows Phone | windowsphone.png | link |
Windows Phone 10.0 | win10.png | link |
Windows Server 2003 | wins2k3.png | link |
Windows Vista | winvista.png | link |
Windows XP | winxp.png | link |
macOS High Sierra | macossierra.png | link |
macOS Sierra | macossierra.png | link |
Supported Browser | Image Name | For More Information |
AOL | aol.png | link |
America Online Browser | americaonlinebrowser.png | link |
Arora | arora.png | link |
Avant Browser | avantbrowser.png | link |
Blazer | blazer.png | link |
Camino | camino.png | link |
ChromePlus/CoolNovo | chromeplus.png | link |
Chromium Web Browser | chromium-webbrowser.png | link |
Columbus | columbus.png | link |
CometBird | cometbird.png | link |
Comodo Dragon | comododragon.png | link |
CompuServe | compuserve.png | link |
Deepnet Explorer | deepnetexplorer.png | link |
DocZilla | doczilla.png | link |
Dolphin | dolphin.png | link |
Dooble | dooble.png | link |
ELinks | elinks.png | link |
Element Browser | elementbrowser.png | link |
Epiphany | epiphany.png | link |
Fennec (Firefox Mobile) | fennec.png | link |
Firebird/Phoenix | phoenix.png | link |
Firefox | firefox.png | link |
Flock | flock.png | link |
Galeon | galeon.png | link |
Google Chrome | googlechrome.png | link |
HPSecureWebBrowser | hp.png | link |
IceApe | iceape.png | link |
IceCat | icecat.png | link |
IceWeasel | iceweasel.png | link |
Iridium | iridium.png | link |
Iron | iron.png | link |
K-Meleon | kmeleon.png | link |
KKman | kkman.png | link |
Konqueror | konqueror.png | link |
Links | links.png | link |
Lunascape | lunascape.png | link |
Lynx | lynx.png | link |
MS Internet Explorer | msie.png | link |
MS Internet Explorer Mobile | msiemob.png | link |
MS Pocket Internet Explorer | msiepock.png | link |
MSNTV | msntv.png | link |
Maxthon | maxthon.png | link |
Microsoft Edge | msedge.png | link |
Mini Browser | minibrowser.png | link |
Minimo | minimo.png | link |
Mozilla Suite | mozilla.png | link |
Netfront | netfront.png | link |
Netscape Navigator | netscape.png | link |
Nintendo Browser | nintendobrowser.png | link |
OffByOne | offbyone.png | link |
OmniWeb | omniweb.png | link |
Opera | opera.png | link |
Orca Browser | orca.png | link |
Origyn | origyn.png | link |
Pale Moon | palemoon.png | link |
Powermarks Bookmark Manager | powermarks.png | link |
Prism | prism.png | link |
RockMelt | rockmelt.png | link |
Safari | safari.png | link |
SeaMonkey | seamonkey.png | link |
Shiira | shiira.png | link |
Silk | silk.png | link |
Stainless | stainless.png | link |
Sylera | sylera.png | link |
Vivaldi | vivaldi.png | link |
WebPositive | webpositive.png | link |
Xiino | xiino.png | link |
iCab | icab.png | link |
w3m | w3m.png | link |
There are seven other optional images that replace other images based on versions or types of the software being used (as the parsing of the useragent continues, as mentioned). If any of these images are missing, they will be replaced with your "missing.png" image or the default image stretched or shrunk to yourtheme's image dimension, based on the "Missing:" line in your "theme.txt" file. These images are as follows:
Image Type | Image Name | Information |
Ubuntu v10 and up | ubuntu10.png | This image replaces the default "ubuntu.png" image for Ubuntu versions 10 or higher, if detected. |
Edubuntu v10 and up | edubuntu10.png | Like above, but for Edubuntu. |
Kubuntu v10 and up | kubuntu10.png | Like above, but for Kubuntu. |
Android WebKit Browser | androidbrowser.png | This is the image used for the default WebKit browser used on Android devices (which otherwise is detected as Mobile Safari). |
MSIE v7 and v8 | msie7.png | This image replaces the default "msie.png" image used for MSIE browsers version 7.x or 8.x. |
MSIE v9 and up | msie9.png | This image replaces the default "msie.png" image for MSIE browsers version 9.x or higher. |
Sony Webkit Browser | sonywebkitbrowser.png | This image represents the browser that is used by the PlayStation 4 console. |
Finally, there are five other optional images that show the layout engine the browser uses (if it is detected or otherwise known). If any of these images are missing, they will be replaced with your "missing.png" image or the default image stretched or shrunk to yourtheme's image dimension, based on the "Missing:" line in your "theme.txt" file. These images are as follows:
Image Type | Image Name | Information |
Webkit Layout Engine | webkit.png | An image to identify the Webkit layout engine. |
KHTML Layout Engine | khtml.png | An image to indentify the KHTML layout engine. |
Gecko Layout Engine | gecko.png | An image to identify the Gecko layout engine. |
Presto Layout Engine | presto.png | An image to indentify the Presto layout engine. |
Trident/Tasman Layout Engine | trident.png | An image to identify the Trident/Tasman layout engine. |
Once you have created your theme, put it in an archive (preferably .zip) and attach it to an email to geoffrey@mobius-design.net. Be sure to include a short description in the email. Also, attach an image (no bigger than 100x50, or I will resize it) that shows some of the images in your theme (I would suggest showing the Windows 7, Mac OSX, Unspecified Linux, Firefox, MSIE, and Safari images, at least).