Geodesic Solutions Community Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Finding/Editing Text ======

How to find and edit text found within our auctions and classifieds software is a common question.  There are essentially a few different places in the software text can be found and edited.  These are the main areas:

  * Within system text: The "main body/middle" part of every page you see in the system contains text that can be edited/managed.  Basically any text you find is included in the {body_html} tag of a page is system text.  You will not need to edit PHP code to change any of this text.  You only need to find that text in the text admin tool to edit it.
  * Within template sets:  The design you see on the client side are contained within html based templates.  The system uses these templates to manage the design you see on the client side.  These templates sometimes need text within them.
  * Within text specific to addons: addons provided by Geo and external developers sometimes need their own text.  This covers any text that appears when you place an addon tag within your designs.

The most important thing to realize with this software is the biggest learning curve with the software is the pages, templates, etc... We promise however that if you just spend the time to understand the layout the opportunities that you will be presented with are endless and you will be able to create your perfect site.

You can find more explanation about the page templates, modules and mainbody content look in the  
[[how_this_software_works/pages_templates_modules/start|How this Auction and Classified Software Works tutorial]]

====== Where is the text search in the admin tool? ======

Look within the following location of your Geo admin tool:

  DESIGN > TEXT SEARCH
  
The admin tool looks like the screenshot below where we have inserted the "sell" search term:

{{ :startup_tutorial_and_checklist:design_configuration:design_tools:design_text_search:text_search1.png?800 }}

Within that screen you'll see:
  - This search box to insert the search text you want to search for no matter where you might think it is.
  - Check whether to show the first occurrence of a search term within a **text object** or all text of the "object" that text is found in. The example screenshot shows the first option
  - Click the search button once you've inserted the text you want to search for in 1 above
  - This is the search results tab for all text found within the {body_html} output for each page.  This will also where search results for text within a module will be found.  All module functionality is placed withing the design using the {module} placement tag.
  - This is the search results tab for all text that's found in a page within an {addon} placement tag.
  - This is the search results tab for all occurrences of the search term within a page template within your design.  By default this only searches templates in your custom template set.  The system templates that format text for the {body_html} system text do not contain "displayed text" and so aren't searched.
  - This is the search results tab for any template filenames that contain the search term

===== System and Module Text Search Results =====

Once you insert a search term and click search by default you'll see results for the system and module text:

{{ :startup_tutorial_and_checklist:design_configuration:design_tools:design_text_search:text_search2.png?800 }}

This screenshot is showing the results specifically for the system text.  The above is explained here:
  - This is the direct link to edit that specific text within the system
  - This is the page name or module name that text is found in.  The above link will link to that text within that pages admin tool or module's admin tool.
  - This is the label for the text returned in your search results.  This describes how that text is used in that page.
  - This is the language that text is found in
  - This is the text actually found in the search results.  Here we are only showing the "first occurrence" search results.  If you want to see the whole text for the "text object" found choose the other option before clicking search

===== Addon Text Search Results Tab =====

When you click the addon text tab you will see the search results for the search within the addon text found within the system.  That admin tool looks like:

{{ :startup_tutorial_and_checklist:design_configuration:design_tools:design_text_search:text_search4.png?800 }}

Within those results you will see:
  - The button that will take you to that admin tool to edit that text within the admin tool
  - The addon name that text is attached to.
  - The text label for that text usually describing how it's used in the page
  - The language that text is attached to
  - The actually text found

===== Template Contents Search Results Tab =====

Clicking the **Template Contents** will expose that search terms results in the page templates found in your template sets.  You'll see results like:

{{ :startup_tutorial_and_checklist:design_configuration:design_tools:design_text_search:text_search5.png?800 }}

Within that screenshot you'll see:
  - This is the link to edit that specific template within the DESIGN > MANAGER admin tool
  - This is the file name and path where that template is found in the template sets
  - This is the actual matching text found in that template

===== Template Filenames Search Results Tab =====

Clicking the **Template Filename** tab will expose the search results for that search term among the file names of all template sets in your installation.  You will see something like the screenshot below:

{{ :startup_tutorial_and_checklist:design_configuration:design_tools:design_text_search:text_search6.png?800 }}

Within that screenshot you will see:
  - The ling to edit that template within the DESIGN > MANAGER admin tool.  Note that you cannot edit default template set templates.
  - The full filename path to the file in the search results 

===== Search Permalink to Return to Results =====

If you find you wish to get back to these search results you can save the "permalink" shown here and return to it easily:

{{ :startup_tutorial_and_checklist:design_configuration:design_tools:design_text_search:text_search3.png?800 }}

Once you find where the occurrence is you can then go to the appropriate admin tool to edit that text.  Below we will cover a specific scenario where text is found within a page template file, the front_page.tpl used on the home page.

====== Page to Page Template Attachment ======

There are numerous ways to find text that you need to edit.  If you are editing a specific page and believe that text to edit is in the page template the first place to start is to go to the template that is assigned to the page that you are wanting to edit. (For emails, this does not apply as they currently do not have templates but when you proceed further into this article hopefully you will also realize where these are edited as well). We are going to use the front page of the software as an example. Let's say that you see some text on the front page that you want to change. The first thing to do is go into the admin and determine which of the templates is used to generate this page. There are two admin tools to find that out.  One is through the PAGES MANAGEMENT admin tool and the other is through the newer DESIGN > PAGE ATTACHMENT admin tool...the former is here:

  PAGES MANAGEMENT > BROWSING LISTINGS > BROWSE CATEGORIES HOME PAGE
  
and looks like:

{{ :startup_tutorial_and_checklist:design_configuration:design_tools:design_text_search:pages_management1.png?800 }}

Within that screenshot you'll see:

  - This is the page template attached to that page in the system
  - This shows the template set that attachment is from
  - You can also edit any language specific text that appears in the {body_html} of that page by using these links.  You'll see one for each language you have within your system
  - Click here to change the page template attached to this page in the system.

The other admin tool to find what page template is in use within a page is the DESIGN > PAGE ATTACHMENTS admin tool shown below.  Also note that while you can get to this admin tool by following DESIGN > PAGE ATTACHMENTS you can also get to it through #4 of the screen shot above:

{{ :startup_tutorial_and_checklist:design_configuration:design_tools:design_text_search:template_attachment1.png?800 }}

Within that screenshot you will see:
  - The edit button to click to change the page template attachment for that page
  - This is the page name within the system describing a bit what that page does.  Note that number preceding that page title is the page id within the system if you ever need that
  - the current page template assigned to that page
  - this is the current "admin editing" template set that page template can be found in.  If you click the template set name you will be sent to the DESIGN > MANAGER admin tool with that template open for editing.

If you click the **edit** button in the above described admin tool (last screenshot) you'll be shown a page like this one:

{{ :startup_tutorial_and_checklist:design_configuration:design_tools:design_text_search:template_attachment2.png?800 }}

Within that screenshot you will see:
  - This is the current template set you are working on.  Any page templates assignments you make in the current page will be made for that template set.  So any changes in the current page will only affect when this template set is in affect.
  - This is the page you are setting template assignments for
  - This the default page template assigned to that page in the system for this template set. It will be used if there are no overriding configurations that are managed below.
  - If you wish to setup a language specific page template for this page within this template set you would do that here.  You will select the language and the template to use for this configuration.  Note though that we suggest you keep specific template sets for each language and assign language specific template sets.  It is much easier to manage if there is more than one page template assignment per language.  You should only use this setting "per language" after careful study or in limited use.
  - After making all the configurations you want in this page click the save button to commit those configurations
  - You can click this to go back to the full page attachments page you most likely clicked from to get to the current page.

Now that we know that the template is the **/main_page/front_page.tpl** (default design) we can then proceed to the templates section of the admin. So....go here in the admin tool:

  DESIGN > MANAGER

This is the file/template manager of the software.  You will immediately see a tool that list all of the template in your currently edited template set in an "explorer type view".  You can find out more about the specifics of how the Manager works and how to use within the [[admin_menu/design/manager/start|Design Manager Explanation]].
Geodesic Solutions Community Wiki

User Tools

Site Tools

Page Tools
