It's easy to have your blogs, emails or web pages link to information in your Keep&Share account. Keep&Share is a great way to host PDF files, shared calendars, photo albums etc. This help page describes how you can link to information in your Keep&Share account, but be sure to read how you can also embed live Keep&Share documents, photos and calendars right inside your web pages.
All you have to do is copy the "URL Link:" gray box which has a URL address:
- For stored files, click on the file name and then there will be a gray box with a URL link. Just copy and paste this URL.
- For calendars, click on 'Customize & Share' and copy the gray "Link" box.
- For documents or photo albums, edit the document or album and save it, and copy the gray "Link" box.
- For share pages, click on the 'share' in the blue bar and copy the gray "Link" box.
- For folders, click on the folder name so just that one folder is displayed, then click the blue 'Link & Embed' command, then copy and copy the gray "Link" box.
Whenever a user clicks any of these pasted links they'll be taken directly to your information, if they have permission to view it (e.g., if it's privately shared, they'll have to log in to view it).
Set the Sharing
Don't forget to set sharing on the stored file, photo album or calendar, so users will be able to see it. The easiest is to set the sharing to 'Public', but you can also assign the sharing to any Keep&Share account names or share groups. Your share page is your public “portal”, so it's not necessary to set sharing on it.
Should You Put a Sign In Box on Your Website?
If you want to make it easy for your website visitors to access privately shared information in your account, we sometimes get asked if web master can put a sign in box on their web page. There is no need to do this, since Keep&Share will automatically show users a sign in screen whenever they try to access privately sharing information. For instance, if you put a link on your web page that points to a calendar that you've privately shared, then when a visitor clicks on that link, they are automatically prompted by Keep&Share to sign in. Once they've signed in, if their account is on the share list for that calendar, Keep&Share takes them directly to the calendar (or whatever it is) that your link points to.
When to Use “?” vs. “&”
URL parameters — when to use “?” vs. “&”. Standard web syntax for URL parameters is a little tricky. The very first parameter in a URL must be preceded by a “?”; all subsequent parameters must start with an “&”. When you add a parameter to a URL, if it already has a “?” then use the “&”. Here is an example of a URL that has several parameters (note the 2 “&” after the first “?”):
Calendar URL Tips
You can copy out a URL link to your calendar by clicking on the “Share” button and copying the link code from the gray box under "URL Link.
Make Your Calendar Links Show a Particular Date or Time Zone
Calendar URL links normally look like this:
When your visitors click on a link, they will be shown your calendar set to today's date based on their own browser's clock. If you instead want them to see a fixed date, you can modify the URL by adding text as highlighted in yellow in these two examples:
The first example shows the month of February 2012, and the second example dhows the day view calendar for May 17, 2012.
The parameter "&tzo=14" forces the embedded calendar to display in a specific timezone. The number is relative to Greenwich Mean Time (GMT). So "&tzo=-8" would be the California time zone which is 8 hours behind GMT. If there is no tzo parameter, the embedded calendar displays with the timezone of the viewer's browser.
Adding a “tzo” parameter is most useful when embedding a calendar in a website and you want the calendar to always display according to the current date/time in that country.
If you bookmark your calendar URL when it has a date parameter in it such as "&date=2012-02-12", then that bookmark will always display your calendar with that date. If you want the bookmark to instead show today, delete the date parameter.
More Calendar URL Tips
- "&exedit=y" in the URL of an iFrame calendar will force the day editor to 'auto expand' (appear in the larger size) when visitors click in a day.
- "&noname=y" in the URL of an iFrame calendar will turn off the display of the calendar Name in the title area.
- "&nonav=y" in the URL of an iFrame calendar will turn off the display of the calendar View icons in the title area. E.g., "&ifr=y&nonav=y&noviewmenu=y&nobreak=y" in the URL gives your calendar URL a very clean single line title area.
- "&nobreak=y" will force the calendar title area to be on a single line in an iFrame, no matter how narrow the iFrame. Set it to "nobreak=n" if you want your calendar title to be on two lines to fit well in a narrow iframe.
- all parameters for iframes (calendar embedding) can be used in any calendar URL so long as it has "&ifr=y" in the URL.
- "&noviewmenu=y" in the URL of an iFrame calendar will turn off the 5 view icons in the calendar title.
- The "i" parameter is the unique id for the account holding your calendar. Every Keep&Share account has a unique "i" number - you'll see it in all URLs when you are logged in to your account. You can copy any of the above embed codes and modify the "i" parameter from "i=889231" to whatever your unique "i" number is.
- The "/calendar/" portion of the URL determines which of the calendars in your account is being referenced (remember, paid accounts provide you multiple calendars in the same account). "/calendar/" references calendar 1. "/calendar4/" references calendar 4.
- add "&sh=n" to any calendar URL to force the left panel to be closed.
- "&nopopup=y" will stop the pop-up day editor from appearing when a visitor clicks on an embedded calendar. "&nopopup=n" will turn the pop up on again.
- The no warning parameter "&nw=y" turns off the display of a warning message when an embedded calendar is displayed in the same browser as which you are logged in.
- "show.php" is the normal calendar viewer and can be embedded to have any of the below 22 views set by the "vw=" parameter (see below).
- "embed_calendar.php" is the day scroll calendar.
- The "&date=2010-03-08" parameter forces a calendar to show a particular date.
- The parameter "&tzo=14" forces the embedded calendar to display in a specific timezone. The number is relative to Greenwich Mean Time (GMT). So "&tzo=-8" would be the California time zone which is 8 hours behind GMT. If there is no tzo parameter, the embedded calendar displays with the timezone of the viewer's browser.
- "&p=y" will remove the logo & header area from the calendar's display.
- "&nopb=y" in an iFrame URL will inhibit the display of the Powered by Keep&Share.
Control the view of your embedded calendar by setting the parameter "vw=" to one of these values:
- year -- year display
- year365 -- year display w/ density
- year@ -- year display w/ headlines
- month -- month display
- month5 -- 5 day week month display
- month7 -- 7 day week month display
- week -- week display
- week1 -- 1 week (column) display
- week5 -- 5 day week display
- week7 -- 7 day week display
- week10 -- 2 week, 5 day week display
- week14 -- 2 week, 7 day week display
- week20 -- 4 week, 5 day week display
- week28 -- 4 week, 7 day week display
- week40 -- 8 week, 5 day week display
- week56 -- 8 week, 7 day week display
- day -- day display
- day1 -- 1 day display
- day2 -- 2 day display
- day3 -- 3 day display
- day4 -- 4 day display
- day5 -- 5 day display
- day6 -- 6 day display
- day7 -- 7 day display
- event -- event display
- event20 -- 20 day event display
- event30 -- 30 day event display
- event45 -- 45 day event display
- event60 -- 60 day event display
- event90 -- 90 day event display
- event120 -- 120 day event display
- sbs -- side-by-side view
- sbse1 -- side-by-side view, 1 day display
- sbse15 -- side-by-side view, 15 day display
- sbse30 -- side-by-side view, 30 day display
For example, this embed code will show your calendar in 5 day week month view (the "vw" parameter is in bold face):
And this embed code will show your calendar in 20 day event view:
Set Your Calendar's Time Zone
You can force your embedded calendar to display in a particular time zone by adding the parameter "&tzo=14" where the number will pick a time zone relative to Greenwich Mean Time. Time zones mostly matter to ensure that Keep&Share displays the correct day as 'today' in the calendar. E.g., &tzo=14 is "14" hours ahead of GMT. You can also use a negative number to indicate a certain number of hours before (negative) GMT. PST would be -8.
Document URL Tips
Immediate Download/View: URL links that point to a stored file such as PDF, Excel or Word can either download the file immediately or first prompt the user whether they want to download. We provide both forms of URL in 2 different gray link boxes. You can edit URLs to control immediate downloading. If the URL includes "da=y" then the link will download/view immediately. Otherwise it will prompt for user confirmation.
http://www.keepandshare.com/doc/2717655/?da=y Immediate download/view
http://www.keepandshare.com/doc/2717655/?da=n Prompts User for Confirmation
http://www.keepandshare.com/doc/2717655/ Prompts User for Confirmation
Here are help screens for popular browsers on PDF viewing issues:
Short URL for Email and Twitter: the 'Short URL' gray boxes provide very short URLs in the form of 'http://kvisit.com/SvoNq'. These are good for pasting into emails, tweets, chat sessions and the like where space is at a premium.
'Replace' an Uploaded File: once you've uploaded a file and given the URL to other people (or put the URL on some web pages), you sometimes want to replace the file but make sure the URL stays the same. No problem. Just click on the blue 'edit' command next to the file, and the next screen gives you instructions on how to upload a replacement file that will have the same URL.
Directly Display a Document: if you want to display a Keep&Share document on the screen without the Keep&Share tabs or user interface, put the document into 'print' view by adding the parameter 'p=y'. If the URL does not yet have a “?”, add it this way: '?p=y'. If the URL already has one “?” in it then add it with an ampersand: '&p=y'. Here are two sample URLs, the first will display the document 'inside' of Keep&Share, the second will display it in print view:
General URL Tips
Force the Left Panel to be Closed: when a user clicks on your link the default is for the left panel to be open and visible. If you would like your link to display with the left panel closed, add the parameter "?sh=n":
Copy a URL address to the Clipboard: Just point your browser at the page you want to link to, and then copy the address out of the browser's address bar. One way to get the address is to right click your mouse in the address bar of the browser. Then select copy from the menu choice that pops up in response to your mouse right click.
Pre-Fill the 'Account Name' Field: If you include a URL parameter '&accountname=mikesguest' in your URL, then, if the visitor to your URL is not already logged in to a Keep&Share account, the log in box will have the account name already filled in (in this case, with 'mikesguest' as the account name). This is useful when you have a 2nd free account that you share with as your guest account. This way your friends do not need their own accounts - they can just log in to your 'guest' account. If you put this parameter into the URL, then all they'll need to remember is their password when they click on your URL. Here is a full example:
Here is another example in which you want to put a link to a photo album on your web page. You want visitors to the web page to have to use a password to view the album, but not to have to remember or enter an account name.
- Copy out the link that points to your photo album, such as this: http://www.keepandshare.com/photo/397756/rose-senoir-year?fv=y&ifr=&vo=lt
- Be sure the photo album is shared with an private account you control, let's pretend its 'suzyguests'.
- Add the accountname parameter to the user, so your hyperlink on your web page points to:http://www.keepandshare.com/photo/397756/rose-senoir-year?fv=y&ifr=&vo=lt&accountname=suzyguests
- Tell your friends the password for 'suzyguests' account.
- Now, when they click on this link they'll be prompted to log in and the accountname field will automatically contain 'suzysguest' - all they have to do is enter the password you gave them. Once they enter the correct password Keep&Share will show them the original URL destination.
Start with Sign In Screen & Specify a 'Go To' page: this URL demonstrates how to create a link that takes the visitor to the sign in page, fills the account name in, and specifies "&goto=" to control the first screen the visitor will see once they are signed in: