Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
PatternSkin Customization | ||||||||
Line: 6 to 6 | ||||||||
Changed: | ||||||||
< < | Logo questions | |||||||
> > | First Read: How to modify PatternSkin templatesIf you need to change any of the elements that are visible on the common 'view' pages, you need to change the 'view' template:/templates/view.pattern.tmpl . The quickest way would be to simply change the text in the template. A safer way - strongly recommended, because it will survive a TWiki update - is to create your own custom skin. That may sound like an awful lot of work, but in reality a skin may be as much as 1 file that consists of only a few lines of code.
Example Let's say you want to simplify the bottom toolbar and remove all links except for "More topic actions". You would need to target %TMPL:DEF{"topicactionbuttons"}% , which is located in view.pattern.tmpl .
The steps you would need:
* Set COVER = myskinor write* Set SKIN = myskin,pattern Logo | |||||||
How can I change the web logo? | ||||||||
Line: 14 to 38 | ||||||||
The default variables that cause this behavior are defined in TWikiPreferences. Redefine your custom variables in Main.TWikiPreferences (to keep TWikiPreferences intact): | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
| ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
There are 2 ways to change the logo in a web: | ||||||||
Line: 27 to 51 | ||||||||
| ||||||||
Added: | ||||||||
> > |
| |||||||
Using a new filename: | ||||||||
Line: 34 to 59 | ||||||||
* Set WEBLOGONAME = your-logo-name.gif-or-png | ||||||||
Added: | ||||||||
> > |
| |||||||
How do I set a site-wide logo?There is a bunch of site-wide logo variables in Main.TWikiPreferences:WIKILOGOIMG , WIKILOGOURL and WIKILOGOALT .
To change only the web logo image to site-wide, in Main.TWikiPreferences set: | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
| ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
My logo does not fit the top bar | ||||||||
Line: 52 to 77 | ||||||||
Using templates:
Change the height of the top bar in | ||||||||
Changed: | ||||||||
< < | ||||||||
> > |
| |||||||
%TMPL:DEF{"topbardimensions"}% #patternTopBar, #patternClearHeaderCenter, | ||||||||
Line: 63 to 89 | ||||||||
overflow:hidden; } %TMPL:END% | ||||||||
Changed: | ||||||||
< < | Only change the number. | |||||||
> > | Only change the number from 64px to another value. | |||||||
Using style sheets: | ||||||||
Line: 74 to 101 | ||||||||
I want to change the white space above and below the logo | ||||||||
Changed: | ||||||||
< < | Change the table style in WebTopBar. Default top padding is 11px. | |||||||
> > | Change the table style in topic WebTopBar. The default top padding is 11px. | |||||||
Changed: | ||||||||
< < | Top bar questions | |||||||
> > | Top bar | |||||||
I want to set or change the top background imageThe image at the top is called "header art" - commonly the top image found on blog sites. The image that is displayed by default is set by the variableWEBHEADERART , defined in TWikiPreferences.
Redefine your custom variables in Main.TWikiPreferences (to keep TWikiPreferences intact): | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
| ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
You can also set WEBHEADERART per web, by defining the variable in the Web's WebPreferences.
I want to have the web color in the top barRedefineWEBHEADERBGCOLOR in Main.TWikiPreferences (to keep TWikiPreferences intact): | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
| ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
I want to remove the Jump and Search boxes from the top bar | ||||||||
Line: 106 to 133 | ||||||||
I want to hide the top barUsing templates: | ||||||||
Changed: | ||||||||
< < | The view template is populated like this:%TMPL:INCLUDE{"page"}% %TMPL:INCLUDE{"viewtopbar"}% %TMPL:INCLUDE{"viewtoolbar"}% %TMPL:INCLUDE{"viewleftbar"}% %TMPL:INCLUDE{"viewrightbar"}% %TMPL:INCLUDE{"viewtopicactionbuttons"}% %TMPL:INCLUDE{"viewbottombar"}%Each included template draws a part of the screen. Omit | |||||||
> > |
The view template is populated with page elements using template inclusions:
%TMPL:INCLUDE{"page"}% %TMPL:INCLUDE{"viewtopbar"}% %TMPL:INCLUDE{"viewtoolbar"}% %TMPL:INCLUDE{"viewleftbar"}% %TMPL:INCLUDE{"viewrightbar"}% %TMPL:INCLUDE{"viewtopicactionbuttons"}% %TMPL:INCLUDE{"viewbottombar"}%Each included template draws a part of the screen. Omit %TMPL:INCLUDE{"viewtopbar"}% to hide the top bar.
Another approach is to clear the contents of module topbar ; for example in view.myskin.tmpl :
%TMPL:INCLUDE{"view"}% %TMPL:INCLUDE{"topbar"}%%TMPL:END%and add:%TMPL:DEF{"topbardimensions"}%#patternTopBar, #patternClearHeaderCenter, #patternClearHeaderLeft, #patternClearHeaderRight, #patternTopBarContentsOuter { height:0px; }%TMPL:END% | |||||||
Using style sheets: | ||||||||
Line: 125 to 174 | ||||||||
See PatternSkinCssCookbookNoTopBar. | ||||||||
Changed: | ||||||||
< < | Left bar questions | |||||||
> > | Left bar | |||||||
I want to hide the left barUsing templates: | ||||||||
Changed: | ||||||||
< < | Omit %TMPL:INCLUDE{"viewleftbar"}% to hide the left bar, or in a view template clear it using %TMPL:INCLUDE{"viewleftbar"}%%TMPL:END% | |||||||
> > | Omit %TMPL:INCLUDE{"viewleftbar"}% to hide the left bar, or in a view template clear it using %TMPL:DEF{"viewleftbar"}%%TMPL:END% | |||||||
Using style sheets: | ||||||||
Line: 146 to 195 | ||||||||
It may defy the wiki-ness of your TWiki installation, but in certain circumstances it could be useful to hide the edit buttons from users that are not logged in, for instance for customers.
Create in the template directory the file view.customer.tmpl . 'Empty' topicaction and toolbar by writing in the template: | ||||||||
Changed: | ||||||||
< < | %TMPL:INCLUDE{"view.pattern"}% %TMPL:DEF{"topicaction"}%%TMPL:END% %TMPL:DEF{"toolbar"}%%TMPL:END% | |||||||
> > | %TMPL:INCLUDE{"view"}% %TMPL:DEF{"topicaction"}%%TMPL:END% %TMPL:DEF{"toolbar"}%%TMPL:END% | |||||||
In TWikiGuest, set the cover to | ||||||||
Changed: | ||||||||
< < | * Set COVER = customer | |||||||
> > | * Set COVER = customer | |||||||
By default this topic is editable only by TWikiAdminGroup members. | ||||||||
Added: | ||||||||
> > | I want to remove the History button from the bottomAll action buttons are defined inviewtopicactionbuttons.pattern.tmpl . Remove module revisions from %TMPL:DEF{"topicactionbuttons"}% .
In your view.myskin.tmpl file (see above) you write:
Test by appending%TMPL:INCLUDE{"view"}% %TMPL:DEF{"topicactionbuttons"}%WYSIWYG | | %TMPL:P{context="WysiwygPluginEnabled" then="activatable_edit_wysiwyg"}% | %TMPL:P{"activatable_attach"}% | %TMPL:P{"printable"}% | %TMPL:P{"raw"}% | %TMPL:P{"backlinks"}% | %TMPL:P{"activatable_more"}%%TMPL:END%Remove all newlines if you copy-paste above text. ?cover=myskin to any topic.
I want to insert text outside of the topic contentPatternSkin has 2 'buckets' to write additional content to:beforetextcontents and aftertextcontents , both defined in view.pattern.tmpl . These containers can contain text or html and are placed directly before and after the topic text.
Both modules are wrapped in CSS containers:
So our view.myskin.tmpl file contains:
Test by appending%TMPL:INCLUDE{"view"}% %TMPL:DEF{"beforetextcontents"}%This is the text before%TMPL:END% ?cover=myskin to any topic.
Use the same procedure for contents to be put after the topic text:
%TMPL:INCLUDE{"view"}% | |||||||
Added: | ||||||||
> > | %TMPL:DEF{"aftertextcontents"}%This is the text after%TMPL:END% |