Geodesic Solutions Community Wiki

User Tools

Site Tools

You are here: Auction and Classified Software Support Home » Admin Menu » Design » Template Sets
admin_menu:design:template_sets:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
admin_menu:design:template_sets:start [2013/09/27 22:09]
jonyo [Template Seek Order] fixed link 		admin_menu:design:template_sets:start [2021/11/10 19:32] (current)
jonyo replace <tip> with <note>
Line 30: Line 30:
 When changing things in the admin panel, it will never allow changes to be made to any templates or media files that are not in the selected template set(s) currently selected for "admin editing". When changing things in the admin panel, it will never allow changes to be made to any templates or media files that are not in the selected template set(s) currently selected for "admin editing".
  
-<tip c n>**Tip:** If you are working on a new design, change **Admin Editing** selection to the template set for the new design.  That way you won't ever accidentally affect the current design while working on a new one!</tip>+<note tip>**Tip:** If you are working on a new design, change **Admin Editing** selection to the template set for the new design.  That way you won't ever accidentally affect the current design while working on a new one!</note>
  
 ==== Template Seek Order ==== ==== Template Seek Order ====
Line 42: Line 42:
  
 This will be the //name// of the template set, which is the folder name for that template set. This will be the //name// of the template set, which is the folder name for that template set.
 +
 +==== Language ====
 +
 +This allows you to attach a template set to a specific language.  Think of this as attaching a template to a language, you do **not** need to set the language for every template set!  If you only have one language, keep that drop-down set to "any language".
 +
 +**Tip:** Set your "main" template set (usually this is my_templates) to "any language" so that it will never fall through to use the default design (with the default logo and all).
 +
 +==== Device ====
 +
 +This column **Added in version 7.3.0**
 +
 +This is similar to the languages column, except instead of loading based on the language, it loads based on what device is detected.  Usually you will set all of your templates to "any device".  As with the language selection, treat this as attaching a template set to a device, you will usually want to use "any device" unless certain templates should only load for mobile.
 +
 +<note>**Note:**  The default design (as of version 7.3.0) uses what is called Responsive Web Design (RWD).  This technique allows the same templates to be used for all devices, and it //responds// to the device's screen size by adjusting the layout of the page.  Because of this, using mobile-only templates are not needed.  We still added the ability to use mobile templates if you wish to give you the choice to use whatever techniques you want for your site.  See the [[designers:philosophy|Design Philosophy]] page for a more in-depth explanation.</note>
  
 ===== Template Set Buttons ===== ===== Template Set Buttons =====
Line 74: Line 88:
  
 ==== Download ==== ==== Download ====
-<tip c n>**Note:** The download functionality requires the server to have **Zip support** installed for PHP.  If your site does not have this requirement, it will say so in the dialog.</tip>+<note>**Note:** The download functionality requires the server to have **Zip support** installed for PHP.  If your site does not have this requirement, it will say so in the dialog.</note>
  
 This button will open a dialog similar to the one displayed below, to allow downloading the entire template set for backup or portability purposes. This button will open a dialog similar to the one displayed below, to allow downloading the entire template set for backup or portability purposes.
Line 101: Line 115:
 Note that if you edit a template using the admin panel, or even upload a file using the admin panel, it will do the re-scan of the attachments for that file automatically.  You will only need to use this button if you have made template changes outside of the admin panel. Note that if you edit a template using the admin panel, or even upload a file using the admin panel, it will do the re-scan of the attachments for that file automatically.  You will only need to use this button if you have made template changes outside of the admin panel.
  
-<tip c n>**Tip:**  If a module or addon tag's contents is not displaying, use the re-scan tool to re-generate the attachment files for the template set.</tip>+<note tip>**Tip:**  If a module or addon tag's contents is not displaying, use the re-scan tool to re-generate the attachment files for the template set.</note>
  
 === Re-Scanning Default Templates === === Re-Scanning Default Templates ===
Line 121: Line 135:
 Using this tool will allow you to import text changes that are **recommended by the template designer**, for a template set to display as intended.  Such text changes usually involve when there are HTML directly in the text, usually images that are part of language text entries. Using this tool will allow you to import text changes that are **recommended by the template designer**, for a template set to display as intended.  Such text changes usually involve when there are HTML directly in the text, usually images that are part of language text entries.
  
-<tip c h>**Tip:**  Template Designers - If you need a certain text entry or entries to be altered for your design to display as intended, you can create your own text import file.  The format is exactly the same as is used for the main text import/export routines, you only need to include rows for text entries that need to be changed.  To use it, just include the text.csv file in the main folder for your template set.</tip>+<note tip>**Tip:**  Template Designers - If you need a certain text entry or entries to be altered for your design to display as intended, you can create your own text import file.  The format is exactly the same as is used for the main text import/export routines, you only need to include rows for text entries that need to be changed.  To use it, just include the text.csv file in the main folder for your template set.</note>
  
 The fields in the dialog are explained in more details below: The fields in the dialog are explained in more details below:
Line 149: Line 163:
 ===== Upload Template Set ===== ===== Upload Template Set =====
  
-<tip c n>**Note:** The upload functionality requires the server to have **Zip support** installed for PHP.  If your site does not have this requirement, it will say so in the dialog.</tip>+<note>**Note:** The upload functionality requires the server to have **Zip support** installed for PHP.  If your site does not have this requirement, it will say so in the dialog.</note>
  
 Use the upload template set button that is below the list of template sets, to upload a template set from a 3rd party template designer, or to restore a template set previously downloaded for backup purposes.  The dialog will look similar to below: Use the upload template set button that is below the list of template sets, to upload a template set from a 3rd party template designer, or to restore a template set previously downloaded for backup purposes.  The dialog will look similar to below:
Line 176: Line 190:
 If a particular template or file exists in more than one of the selected template sets, the one that is used is the one that would have been chosen by the template system, or the one that is in the template set "higher up" in the **Template Seek Order**. If a particular template or file exists in more than one of the selected template sets, the one that is used is the one that would have been chosen by the template system, or the one that is in the template set "higher up" in the **Template Seek Order**.
  
-<tip c n>**Tip:**  The **Merge Sets Together** button is a handy tool if you currently have your templates scattered across a few different template sets, and you want to combine them into one single template set!</tip>+<note tip>**Tip:**  The **Merge Sets Together** button is a handy tool if you currently have your templates scattered across a few different template sets, and you want to combine them into one single template set!</note>
  
 See below for more information on each field within the dialog. See below for more information on each field within the dialog.
Line 186: Line 200:
 **What template types:**  Check the box next to each “template type” (in other words, the direct sub-folders for each template set). It is recommended to only copy main_page and external (the ones checked by default).  Keep in mind that every **system/**, **module/** or **addon/** file that exists in a template set, may require changes when you update the software to a newer version, so only use such files in a template set that you intent to customize. **What template types:**  Check the box next to each “template type” (in other words, the direct sub-folders for each template set). It is recommended to only copy main_page and external (the ones checked by default).  Keep in mind that every **system/**, **module/** or **addon/** file that exists in a template set, may require changes when you update the software to a newer version, so only use such files in a template set that you intent to customize.
  
 +===== Create Main Template Set =====
 +
 +Use this button to create your main template set based off of the current default templates.  **Always** use this when you are creating a new template set that you want to start from the default templates, you should **never** make a copy of the default templates directly!
 +
 +This tool will copy over the main_page templates, along with external folder with images and such, and create a custom.css file for you to add your custom CSS to.  It only copies the templates and media files that are "safe" to have a copy of, it does not copy system or module templates for example.  The files that it does not copy, are because those are templates that are used directly by the software, and are very likely to change in new versions.  If you have a copy of such files in your own templates, you must apply changes every time you update or it may break things in the software.
 +
 +As long as you use this tool to update the software, future updates should be relatively smooth.  That is the main purpose of this tool, to make sure the template set is update friendly.
 +
 +Use of the "create main template set" button is not recommended for creating copies of the working template sets if your site design is based on one of the secondary template sets available from our site like the tempo, marquee or fusion template sets.  If you working template design is based on the tempo, fusion or marquee designs and you wish to make copy of the working template design (possibly for versioning purposes) or you wish to leave the original state of the working template set for "return to starting point" reasons you should use the "copy" feature next to that template set within the DESIGN > TEMPLATE SETS admin tool.  This will copy all files in that template set to a new template set to begin work on.
 ====== Advanced Settings ====== ====== Advanced Settings ======
  
admin_menu/design/template_sets/start.1380319753.txt.gz · Last modified: 2014/09/25 16:55 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
CC Attribution-Noncommercial-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki