Docs

How to Use the Custom Code Settings

[edit] Please Note

These docs are now deprecated, we have a new Support area located here

(Difference between revisions)
(→How To Activate the Child Editor 200px|thumb|right|alt=Custom Code|Custom Code)
 
(81 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
[[Category:New Page]]
+
__NOTOC__
−
One of the most dynamic features of Pagelines is the ability to modify or add Custom CSS to your site.
+
[[Category:Framework]]
−
 
+
The Custom Code settings is one of the three ways you can add custom [[Glossary#CSS|CSS]] to your site. The other methods for adding custom CSS are the [[Glossary#PageLines Customize Plugin|PageLines Customize Plugin]] & the [[Glossary#Base Theme|Base Theme.]] You also use the Custom Code Settings to add Header & Footer scripts and Analytics.
−
==What is CSS?==
+
<br /><br />
−
# CSS stands for Cascading Style Sheets
+
[[File:Custom-Code.png|200px|thumb|right|alt=Custom Code|Custom Code]]
−
# Styles define how to display HTML elements
+
−
# Styles were added to HTML 4.0 to solve a problem
+
−
# External Style Sheets can save a lot of work
+
−
# External Style Sheets are stored in CSS files
+
−
# Go to http://www.w3schools.com/css/ to find out more
+
−
<h2>CSS Solved a Big Problem</h2>
+
−
 
+
−
HTML was never intended to contain tags for formatting a document.
+
−
 
+
−
HTML was intended to define the content of a document, like:
+
−
 
+
−
<h2 style="color: red">This is a heading with a Red color style</h2>
+
−
 
+
−
<p>This is a paragraph.</p>
+
−
 
+
−
When tags like <font>, and color attributes were added to the HTML 3.2 specification, it started a nightmare for web developers. Development of large web sites, where fonts and color information were added to every single page, became a long and expensive process.
+
−
 
+
−
To solve this problem, the World Wide Web Consortium (W3C) created CSS.
+
−
 
+
−
In HTML 4.0, all formatting could be removed from the HTML document, and stored in a separate CSS file.
+
−
 
+
−
All browsers support CSS today.
+
−
 
+
−
==Add Custom Code==
+
−
The below example shows how to add or modify a site's CSS. Follow similar steps for all Custom CSS.
+
 
From your WordPress Administration Panel:
 
From your WordPress Administration Panel:
  
−
# Under Pagelines, select the "Custom Code" panel.[[File:Custom-css.png|200px|thumb|right|alt=Custom Code Panel|Custom Code Panel]]
+
# Select the "PageLines" panel, then "Settings"
−
# In the CSS Rules box, enter the Custom CSS code you want to use to modify or add a specific CSS rule
+
# Select the "Custom Code" tab to show the following options:
−
# For example, to change the margin at the top of your page: You would add, body {padding-top: 15px;}
+
−
# Next, click the "Save Options" button in the upper right hand corner
+
−
# The Custom Code is dynamic which means that it will over-write the default Pagelines CSS settings.
+
−
# Remember: Proper CSS code format must be used in Custom CSS:
+
−
#navigation_rss {position: absolute;
+
−
        left: 720px;
+
−
        font-family: Verdana, Arial, Helvetica, sans-serif;
+
−
        text-transform: uppercase;
+
−
        color: #897567;
+
−
        line-height: 2.5em;}
+
  
−
==Other Features of the Custom Code Panel[[File:Custom-css2.png|200px|thumb|right|alt=Custom Code|Custom Code]]==  
+
==Custom CSS==
−
In addition to being able to add Custom CSS in the Custom CSS Panel, javascripts can be added to both the header and the footer.There is also a section to add Google asynchronous analytics code script.
+
This setting is a simple quick way to add custom styles to your site without having to edit any css files. Anything you enter here will be saved to your database. '''Always remember to backup your database.'''
−
# To add script, simply paste the desired script into the header or footer sections of the Custom CSS Section.
+
−
# To add Google Analytics, simply copy the Google script from your Google Analytics account into the Google section of the panel.
+
−
# Next, click the "Save Options" button in the upper right hand corner.
+
  
−
==How to use CSS Inspection Tools==
+
# Enter the Custom CSS code you want to use to modify or add a specific CSS rule
−
<h3>Installing Firebug</h3>
+
#* For example, to change the margin at the top of your page: You would add, body {padding-top: 15px;}
−
There are a couple of FREE CSS Inspection Tools which can be used to do this. They are Firebug and Google's Chrome Inspection tool.
+
# Click "Save Options"
−
[[File:Firebug.png|200px|thumb|right|alt=Install Firebug|Install Firebug]]
+
−
From Mozilla Firefox:
+
−
# Go to http://getfirebug.com/
+
−
# Download and install the Firebug extension
+
−
# Once installed you will see the Firebug icon in the upper right-hand corner of Firefox.
+
  
−
==Using Firebug To Change Padding of an element==
+
Even though using this Custom CSS setting will give you the results you are looking for, is easy to use, and is considered perfectly safe, it is not necessarily considered to be the best, or most "professional" method for adding CSS to your site. If you are adding more than just a few simple lines of CSS, and would like to use a more professional approach, we recommend using either the [[Glossary#PageLines Customize Plugin|PageLines Customize Plugin]] or the [[Glossary#Base Theme|Base Theme,]] both available for free in the [[Glossary#Store|PageLines Store.]]<br /><br />
−
[[File:Usingfirebugchangecss.png|200px|thumb|right|alt=Selecting elements|Selecting elements with Firebug]]
+
For more information on CSS & how it relates to PageLines 2.0, click on [[Custom CSS]]
−
From Mozilla Firefox:
+
−
# Go to your site
+
−
# Click on the Firebug icon in the upper right-hand corner of your browser
+
−
# Click on the Inspection icon on the Firebug interface
+
−
# Next, click on the section of the page to be inspected
+
−
# Upon clicking any element you will see the corresponding HTML and CSS code highlighted in Firebug
+
−
# Copy the CSS code you are wanting to change
+
−
# Return to the Pagelines Settings and select "Custom CSS"
+
−
# Paste the CSS code that is being altered into the Custom CSS section
+
−
# "Save Options" and refresh your browser to see the changes
+
  
−
==Using Google's Chrome To Change Padding of an element==
+
==Header Scripts==
−
[[File:UsingchromeInspectiontool.png|200px|thumb|right|alt=Selecting elements|Selecting elements with Chrome's Inspection Tool]]
+
This is where you add any scripts you may have such as JavaScript. The script will be inserted directly before the end of the HTML </head> tag
−
From Google Chrome: (The CSS Inspection Tool is built into Chrome)
+
−
# Go to your site
+
−
# Right Click anywhere on the page and then click "Inspect Element"
+
−
# Click on the Inspection icon on the bottom row of the Inspection interface
+
−
# Next, click on the section of the page to be inspected
+
−
# Upon clicking any element you will see the corresponding HTML and CSS code highlighted in Firebug
+
−
# Copy the CSS code you are wanting to change
+
−
# Return to the Pagelines Settings and select "Custom CSS"
+
−
# Paste the CSS code that is being altered into the Custom CSS section
+
−
# "Save Options" and refresh your browser to see the changes
+
  
−
==The CSS Hierarchy==
+
# Enter your Header script into the text area
−
When a webpage loads there is an order (hierarchy) by which the CSS of a page is loaded.
+
# Click "Save Options"
−
# The site's "style.css" will load first
+
−
# The "dynamic.css" will load second
+
−
# The modifications in the "Custom CSS Section" will load next
+
−
# If the Customize Plugin CSS is activated, it will load last
+
−
It is important to keep this hierarchy in mind because the CSS that loads last will take priority over any CSS loaded before it.
+
  
−
==The Difference Between the PageLines Customize plugin & the Custom CSS section ==
+
==Footer Scripts & Analytics==
−
The "Custom CSS" section is a simple quick way to add custom styles to your current site design.
+
This is where you insert any footer script, including Google Analytics.
 +
<br /><br />
 +
For more information, click on [http://www.google.com/analytics/ http://www.google.com/analytics]
  
−
The PageLines Customize plugin is a more comprehensive way to customize your theme. It is a way to create child themes for your site through the plugin to add CSS but also functions, hooks and anything you want to customize your site.
+
# Enter your Footer script and any Analytics script into the text area
−
<h3>Some of the differences</h3>
+
# Click "Save Options"
−
# The Custom CSS section only allows you to customize CSS
+
−
# In version 1.5 of PagelinesPro there was a base child theme
+
−
# The PageLines Customize plugin replaces the base child theme, allowing you to do the same types of customizations from the plugin rather than from an entirely separate child theme
+
−
# The Custom CSS is just for quick CSS changes, you would not want to use it to re-theme your entire site
+
−
# It also gives you the ability to customize child themes without your changes being overwritten when you update the child theme
+
−
# If you download iblogpro5 and want to customize it, those changes will stick around when you update to iblogpro6
+
−
 
+
−
==How To Activate the Child Editor [[File:Childeditor.png|200px|thumb|right|alt=Custom Code|Custom Code]] ==
+
−
Once the PageLines Customize plugin has been installed and activated, you can use the Child Editor plugin to modify the "styles.css" From your WordPress Administration Panel:
+
−
From your WordPress Administration Panel:
+
−
# Go to your PageLines Settings
+
−
# Choose "Store"
+
−
# Then choose "Plugins"
+
−
# Then "Top Free"
+
−
# Install the Child Editor plugin
+
−
# The physical path to the style.css file is located (wp-content\plugins\pagelines-customize)
+
−
 
+
−
==Using the Child Editor plugin to edit files created by the PageLines Customize Plugin[[File:EditingStyle-ChildEditor.png|200px|thumb|right|alt=Child Editor|Child Editor]]==
+
−
Once the PageLines Customize plugin has been installed and activated, you can use the Child Editor plugin to modify the "styles.css"
+
−
From your WordPress Administration Panel:
+
−
# Go to your PageLines Settings
+
−
# Then click on "Child Editor"
+
−
# Next, insert the custom css under the "Style" tab
+
−
# Save your work
+
  
−
==Other Functions of Child Editor Plugin[[File:Cildeditor-functions.png|200px|thumb|right|alt=Child Editor|Other Uses]]==
+
==Asynchronous Analytics==
 +
This is the placeholder for Google asynchronous analytics. It goes underneath body tag.
 +
<br /><br />For more information, click on
 +
[http://code.google.com/apis/analytics/docs/tracking/asyncUsageGuide.html http://code.google.com/apis/analytics/docs/tracking/asyncUsageGuide.html]
  
−
# The Child Editor plugin allows you to edit the "Functions.php"
+
# Copy the Asynchronous Analytics script from your Google Analytics account into the text area
−
# It also allows you edit the site's "Page Base" theme
+
# Click "Save Options"

Latest revision as of 21:15, 18 January 2012

The Custom Code settings is one of the three ways you can add custom CSS to your site. The other methods for adding custom CSS are the PageLines Customize Plugin & the Base Theme. You also use the Custom Code Settings to add Header & Footer scripts and Analytics.

Custom Code
Custom Code

From your WordPress Administration Panel:

  1. Select the "PageLines" panel, then "Settings"
  2. Select the "Custom Code" tab to show the following options:

[edit] Custom CSS

This setting is a simple quick way to add custom styles to your site without having to edit any css files. Anything you enter here will be saved to your database. Always remember to backup your database.

  1. Enter the Custom CSS code you want to use to modify or add a specific CSS rule
    • For example, to change the margin at the top of your page: You would add, body {padding-top: 15px;}
  2. Click "Save Options"

Even though using this Custom CSS setting will give you the results you are looking for, is easy to use, and is considered perfectly safe, it is not necessarily considered to be the best, or most "professional" method for adding CSS to your site. If you are adding more than just a few simple lines of CSS, and would like to use a more professional approach, we recommend using either the PageLines Customize Plugin or the Base Theme, both available for free in the PageLines Store.

For more information on CSS & how it relates to PageLines 2.0, click on Custom CSS

[edit] Header Scripts

This is where you add any scripts you may have such as JavaScript. The script will be inserted directly before the end of the HTML </head> tag

  1. Enter your Header script into the text area
  2. Click "Save Options"

[edit] Footer Scripts & Analytics

This is where you insert any footer script, including Google Analytics.

For more information, click on http://www.google.com/analytics

  1. Enter your Footer script and any Analytics script into the text area
  2. Click "Save Options"

[edit] Asynchronous Analytics

This is the placeholder for Google asynchronous analytics. It goes underneath body tag.

For more information, click on http://code.google.com/apis/analytics/docs/tracking/asyncUsageGuide.html

  1. Copy the Asynchronous Analytics script from your Google Analytics account into the text area
  2. Click "Save Options"
Retrieved from "http://www.pagelines.com/wiki/index.php?title=How_to_Use_the_Custom_Code_Settings&oldid=3942"