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:

  1. 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.
  2. For calendars, click on 'Customize & Share' and copy the gray "Link" box.
  3. For documents or photo albums, edit the document or album and save it, and copy the gray "Link" box.
  4. For share pages, click on the 'share' in the blue bar and copy the gray "Link" box.
  5. 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).

To immediately view a PDF file after a user clicks on a URL link, copy out the "Immediate download/view" gray URL link. Since this URL ends with a "?da=y", that tells Keep&Share to try to display the file in the browser rather than prompt for download.

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 “?”):

https://www.keepandshare.com/calendar/show_month.php?i=67&cat=&fclick=y

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:

/calendar/show_month.php?i=634234

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:

/calendar/show_month.php?i=563457&date=2012-02-12
/calendar/show_daily.php?i=75667&date=2012-05-17

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.

/calendar/show_month.php?i=563457&tzo=2

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.

Bookmarking Dates

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:

  1. year -- year display
  2. year365 -- year display w/ density
  3. year@ -- year display w/ headlines
  4. month -- month display
  5. month5 -- 5 day week month display
  6. month7 -- 7 day week month display
  7. week -- week display
  8. week5 -- 5 day week display
  9. week7 -- 7 day week display
  10. week20 -- 4 week, 5 day week display
  11. week28 -- 4 week, 7 day week display
  12. day -- day display
  13. day1 -- 1 day display
  14. day2 -- 2 day display
  15. day3 -- 3 day display
  16. day4 -- 4 day display
  17. day5 -- 5 day display
  18. day6 -- 6 day display
  19. day7 -- 7 day display
  20. event -- event display
  21. event20 -- 20 day event display
  22. event30 -- 30 day event display
  23. event60 -- 60 day event display
  24. event90 -- 90 day event display
  25. sbs -- side-by-side view

For example, this embed code will show your calendar in 5 day week month view (the "vw" parameter is in bold face):

<iframe src="http://www.keepandshare.com/calendar/show.php?i=533&ifr=y&colorreset=y&nw=y&nomenu=n&noname=n&vw=month5&themeChoice=0&md=9" width="700" height="600" scrolling="no" frameborder="1">

And this embed code will show your calendar in 20 day event view:

<iframe src="http://www.keepandshare.com/calendar/show.php?i=533&ifr=y&colorreset=y&nw=y&nomenu=n&noname=n&vw=event20&themeChoice=0&md=9" width="700" height="600" scrolling="no" frameborder="1">
Converting old embed codes: prior to April 2012, embed codes included URLs that had names such as "show_month.php", "show_daily.php", and "show_event.php". These old embed codes continue to work but will not accept all the above parameters. You might want to update your old embed code. You can edit those embed codes by hand to say "show.php" and then include a "vw=" parameter. Or you can just use the interactive embed calendar configuration tool, and generate a brand new embed code to replace your old embed code.
URL that displays just your calendar: if you add "&p=y&sh=n" to your URL, the calendar will display with no header and the left panel 'closed'. Here is a sample URL: http://www.keepandshare.com/calendar/show_month.php?i=533&p=y&sh=n

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

My PDF will not immediately view. If your PDF URL has &da=y and it does not view immediately in your browser, it has nothing to do with Keep&Share. It has to do with how your browser is configured and equipped for PDF viewing. Many browsers need an additional PDF viewing plugin to be installed and configured to support immediate viewing. Please consult your browser's help system, or try another browser such as Chrome or Safari.

Here are help screens for popular browsers on PDF viewing issues:

Can I stop the viewer from downloading my PDF? No, there is not an option to do this, since PDF files that are viewed in browsers are viewed using the browser's PDF module, and Keep&Share cannot control the 'save' command in the browser's PDF module.

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:

http://www.keepandshare.com/doc/40240/fun-things-to-do-on-a-date
http://www.keepandshare.com/doc/40240/fun-things-to-do-on-a-date?p=y

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":

http://www.keepandshare.com/doc/40240/fun-things-to-do-on-a-date?sh=n
http://www.keepandshare.com/calendar/show_month.php?i=533&sh=n
Remember to use "?" only for the first parameter, and "&" for all subsequent parameters.

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:

http://www.keepandshare.com/visit/visit_page.php?i=636577&accountname=mikesguest

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:

https://www.keepandshare.com/index_signin.php?accountname=sharonglen_members&goto=https://www.keepandshare.com/calendar/show.php?i=1983247&vw=week