Gadgets Views

From VZ Developer Wiki
Jump to: navigation, search

Profile View (PROFILE)

If the gadget supports preferences, the owner of the profile can set them within this view. Visitors will see this preferences (i.e. url of a RSS-feed). The gadget will also be installable on user profiles through the “Will ich auch!”-button, if the gadget has a profile view. The profile pages are the most visited pages and you should remember that the profile view has probably the largest viral effect to spread your gadget to other profiles.

Profile settings.jpg

profile view with size: 390 x 400 px

PROFILE

Owner
Owner of currently viewed profile
Place on platform
Profile page and "My Apps"
Size
390x400px, fixed width, height can be smaller

NOBLEPROFILE

Owner
Owner of currently viewed profile
Place on platform
Profile page of a noble profile (Edelprofil)
Size
390x400px, fixed width, height can be smaller or bigger
Fallback
PROFILE

Group View (GROUP)

The gadget will also be installable on user profiles through the “Will ich auch!”-button, if the gadget has a profile view.

Group.jpg

group view with size: 390 x 400 px

GROUP

Owner
no owner
Place on platform
In a group, when it is installed there
Rendered when
the current viewer has not installed the gadget
Size
390x400px, fixed width, height can be smaller

GROUPINSTALLATION

Owner
Current Viewer
Place on platform
In a group, when it is installed there
Rendered when
the current viewer has installed the gadget
Size
390x400px, fixed width, height can be smaller
Fallback
GROUP

Preview View (PREVIEW)

The preview view picture has a fixed size of 195 x 200 px. The view is shown within the gadget installation process.

Preview.jpg


PREVIEW

Owner
no owner
Place on platform
During Installation process, on the Gallery Frontpage, on the Gadget Installation Settings page
Size
195x200px, fixed width, fixed height

Canvas View (CANVAS)

The canvas view is an extension of a brand community/brand profile/user profile gadget (in which case there’ll be separate navigational elements within the gadget title bar to access the various views.).

The maximum canvas view height can be 2000 pixel. The width remains fixed.

Canvas.jpg

canvas view with the fixed size: 800 x 400 to 2000 px

CANVAS

Owner
Owner of currently viewed profile
Place on platform
Magnification from Profile page and "My Apps"
Size
800x600px, fixed width, height can be smaller and bigger (max. 2000px)

GROUPCANVAS

Owner
no owner
Place on platform
Magnification from a group, when it is installed there
Rendered when
the current viewer has not installed the gadget
Size
800x600px, fixed width, height can be smaller or bigger (max. 2000px)

GROUPCANVASINSTALLATION

Owner
current viewer
Place on platform
Magnification from a group, when it is installed there
Rendered when
the current viewer has installed the gadget
Size
800x600px, fixed width, height can be smaller or bigger (max. 2000px)
Fallback
GROUPCANVAS

NOBLEPROFILECANVAS

Owner
Owner of currently viewed profile
Place on platform
Magnification from Profile page of an noble profile (Edelprofil)
Size
800x600px, fixed width, height can be smaller and bigger (max. 2000px)
Fallback
CANVAS

Pop-up View (POPUP)

The Pop-up view enables a user to install the gadget. It is not possible to include a uninstall function within the Pop-up view.

The default size of the popup is 600x400px, but you can change this size when opening the popup from your gadget (See Gadgets.views_(v0.9)#gadgets.views.requestNavigateTo for details).

Popup.jpg

POPUP

Owner
no owner
Place on platform
a popup
Rendered when
the current viewer has not installed the gadget
Size

POPUPINSTALLATION

Owner
current viewer
Place on platform
a popup
Rendered when
the current viewer has installed the gadget
Size
Fallback
POPUP

Integration View (INTEGRATION)

The Integration view displays the gadget with the maximum possible width of our site without titlebar and menu.

Integration.jpg

integration view with the size: 626 x 400 to 2000 px

INTEGRATION

Owner
no owner
Place on platform
Special page
Rendered when
the current viewer has not installed the gadget
Size
no limitation

INTEGRATIONINSTALLATION

Owner
current viewer
Place on platform
Special page
Rendered when
the current viewer has installed the gadget
Size
no limitation


Embedding

Embed Views enables the gadget to be embedded throughout the network into user generated content, such as wall post, messages or status updates. See Lesson_18:_Embedding_a_gadget_into_user_generated_content_using_an_EMBEDPROVIDER_view for a detailed tutorial.

2 wallpost.png

EMBED

Owner
creator of embed link
Place on platform
an embedded gadget in user generated content
Size
depends on the place where it is embedded (feed, wall, group etc), so you should make your view scaleable

EMBEDPROVIDER

Owner
current viewer
Place on platform
view the user uses to create an embed link
tba

Mobile

The mobile view makes the gadget available for mobile devices like the VZ iPhone Client. See Mobile_Apps for more details.

MOBILECANVAS

Owner
current viewer
Place on platform
mobile VZ-clients like iPhone or Android
Size
depends on device screen, gadget should be resizable

Navigation Between Views

Currently, we support the following gadget integrations:

  • gadgets in brand communities
navigation between GROUP and CANVAS VIEW (if available) through an icon in the titlebar
a separate link is placed within the canvas view to navigate back to the brand community
  • gadgets in brand profiles
navigation between PROFILE and CANVAS VIEW (if available) through an icon in the titlebar
a separate link is placed within the canvas view to navigate back to the brand profile
  • gadgets in user profiles
navigation between PROFILE and CANVAS VIEW (if available) through an icon in the titlebar
a separate link is placed within the canvas view to navigate back to the user profile

Please review our technical guidelines and make sure you are familiar with the google gadget specification.