PF Enterprise FAQ
Common questions about setting up and maintaining a PF Enterprise site.
| Table of Contents | ||||
|---|---|---|---|---|
|
Umbraco & FTP Access
Umbraco: http://pages.photofinale.com/umbraco/
FTP: ftp://pages.photofinale.com
Your credentials for both will be provided by your account manager.
Content Cache
Changes to content made within Umbraco or to files in your FTP directory can take some time to show up on the site due to caching.
| Wiki Markup |
|---|
{table-plus:width=55%}
|| Type || Cache Duration ||
| Changes to Umbraco Content | Up to 60 Minutes |
| Changes to FTP Content | Up to 15 Minutes |
{table-plus} |
| Info |
|---|
To facilitate development, you can point your browser to our sandbox server, which only caches Umbraco content for 1 minute (after you have flushed the cache via myLab). This makes rapid-fire change-and-test cycles much easier. You can hit the sandbox version of your site at any time by using the address: https://*yoursitename*.pfsandbox.com. |
CSS Styling
We strongly recommend that you provide an appropriate css namespace scope for your styles to ensure they do not conflict with the default Photo Finale styling.
In practice, this simply means placing all of your custom content in a <div> with a unique parent class name, for example:
| Panel |
|---|
<div class="dealer-name">
</div> |
Then each style defined in your CSS file should use that parent selector to define the styles. Setting the font-size of the <legend> element, for example will look like:
| Panel |
|---|
.dealer-name legend { |
Your style sheets will always be included after the default Photo Finale style sheets, so it is therefore possible for you to override any of the default PF styling by omitting the .dealer-name scope, for example:
| Panel |
|---|
legend { |
| Note |
|---|
We recommend against overriding the default Photo Finale styling, except as noted below. Lucidiom cannot take responsibility nor provide engineering resources to help diagnose or debug problems caused by overrides to the default styles. Ensuring that the default styling is compatible with all supported browsers on OS X and Windows is enough fun for us already! |
Most PF Enterprise sites will need to override certain PF layout styles, shown here. The values of the #header.pageLayout height and #content.fullpage top should be the same and should represent the actual height of your header content.
| Panel |
|---|
/* Photo Finale Overrides */ #pageWrapper { #header.pageLayout { #content.fullpage { #footer { |
Reserved Page Names
The following names are reserved by Lucidiom and should not be used as page or folder names within Umbraco. This list may change from time to time.
- account
- addphotos
- ccvinfo
- changepassword
- checkout
- confirmation
- create
- default
- forgotpassword
- get
- getstarted
- gift
- gifts
- guest
- home
- link
- members
- membershipinfo
- migrateuser
- mycart
- mycollections
- myfeeds
- myorders
- myphotos
- orderhistory
- optout
- photo
- photos
- photofeed
- prepaidplans
- pricelist
- prints
- projects
- share
- shop
- signin
- signout
- signup
- signupcomplete
- startsharing
- terms
- trackmyorder
- trackorder
- transferconten
- unsubscribe
- upgrade
- user
JavaScript Libraries
Photo Finale includes a number of JS libraries. Umbraco content that includes these same libraries (or different versions of them) will likely cause conflicts and should be avoided.
- ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js
- ajax.googleapis.com/ajax/libs/jqueryui/1.10.2/jquery-ui.min.js
- json2.js
- jquery.fancybox-1.3.4.js
- jquery.blockui.js
- jquery.linq.js
| Note |
|---|
The versions included are updated regularly. We'll endeavor to keep this page up-to-date, but you can always verify by simply doing a View Source on one of your pages in PF Enterprise. |
Customer Sign-In
There are several methods available to hook up a "Sign In" link to
- Method 1 - CSS:
Give your <href> an html id of "signInLink" and class of "no-user signin iframe". - Method 2 - JavaScript:
The following Javascript call will connect your Sign In link to the appropriate action.Panel bgColor #e4f4fb
PF.loginDialog(<jquerySelector>);
JavaScript Client Objects
PF Enterprise provides a pair of JavaScript objects (PF and OrderSummary) that are available to be used in Umbraco pages and PageParts.
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
PF.user.isAuthenticated : bool |
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
OrderSummary.confirmation : int |
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
PF.showError( message ); |
jQueryUI Usage
If you plan to use jQueryUI in your Umbraco content, please note that we provide a base set of jQueryUI styles. You should plan to provide overrides for all of our default stylings. Contact us for additional details.
Tips
- Typekit: If you use Typekit for the fonts and you can see the site make the font switch from a default to your special font, you are experiencing "FOUT" = flash of unstyled text. You can add code to the stylesheet not to load the page until the font is loaded. More info: http://help.typekit.com/customer/portal/articles/6852-controlling-the-flash-of-unstyled-text-or-fout-using-font-events
- Put a ‘My Projects’ button in even for anonymous users. They're cookie based. Tied to the user's browser. Just like the anonymous user's shopping cart.
- Use relative links. Relative links are best. If you need it to a link to a secure page like ‘checkout’ then add the class=”secure” attribute to the anchor element. (or sign in)
- Linking to products/groups. Use short links like shop/photo-books instead of the direct links generated from Lab 50
- Newsletter signup. html can’t have a <form> within a <form>. The site is already wrapped in a <form> so any others get tossed out. The submit would need to be scripted or pop something up.