<chapter id="flickrexport">
<chapterinfo>

<title>Flickr Export</title>

<authorgroup>
    <author>
        <firstname>Vardhman</firstname><surname>Jain</surname>
        <affiliation><address><email>vardhman at students dot iiit dot net</email></address></affiliation>
    </author>
    
    <author>
        <firstname>Gilles</firstname><surname>Caulier</surname>
        <affiliation><address><email>caulier dot gilles at gmail dot com</email></address></affiliation>
    </author>
</authorgroup>

<abstract>
  <para>
  FlickrExport Kipi-plugin allows the user to upload photos to the <ulink url="http://www.flickr.com">Flickr</ulink> web service.
  </para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Kipi</keyword>
</keywordset>
</chapterinfo>

<title>Introduction</title>

  <para>
  Flickr is an online photo management application on internet. Flickr is a way to get your photos to the people who matter to you. With Flickr you can show off your favorite photos to the world, blog the photos you take with a cameraphone, and securely and privately show photos to your friends and family around the world.
  </para>
  
  <para>
  The FlickrExport plugin can be used to upload image collection from your host to the remote flickr server using internet.
  </para>

<sect1 id="using-plugin-flickrexport"> 
  <title>Plugin initialization on first access</title>
  
  <para>
  On accessing the plugin for the first time the user is taken through the process of obtaining a token. Which is used for authentication purposes.
  Following dialog will popup and a browser window will be launched where user will signup in to <ulink url="http://www.flickr.com">Flickr</ulink>.
  </para>
  
  <figure id="flickrexport-first-signup-dialog">
      <title>The First Sign Up Dialog Preview</title>
      <mediaobject><imageobject>
        <imagedata srccredit="The First Sign Up Dialog Preview" fileref="flickrexportsignup.png"/>
      </imageobject></mediaobject>
  </figure>
  
  <para>
  On successful signup FlickrUploadr will be allowed to send photos to flickr website. The user will be presented with the following page on
  successful signup.
  </para>
  
  <figure id="flickrexport-successful-signup">
      <title>The Successful Signup Flickr page</title>
      <mediaobject><imageobject>
        <imagedata srccredit="The Successful Signup Flickr page" fileref="flickrexportauthenticated.png"/>
      </imageobject></mediaobject>
  </figure>
  
  <para>
  Simply close the browser windows and return to the host application Dialog. On clicking <guilabel>Yes</guilabel>, user will see the interface to upload photos to Flickr. Described in the next section.
  </para>

</sect1>

<sect1 id="uploading-using-plugin-flickrexport"> 
<title>The Regular Plugin Usage</title>

  
  <para>
   When the flickrexport plugin is invoked for second time or later the user is greeted with the following dialog, which shows the current access permissions flickrexport plugin has. The uploading process requires "write" permissions. The plugin doesn't allow any other permission as of now. User is asked if he wants to proceed with his current permissions.
    </para>
     <figure id="flickrexport-current-permissions-dialog">
      <title>Current Permissions Dialog preview</title>
      <mediaobject><imageobject>
        <imagedata srccredit="The " fileref="flickrexportcontinue.png"/>
      </imageobject></mediaobject>
  </figure>

      <para>
   On clicking <guilabel>Yes</guilabel>, user will see the interface to upload photos to Flickr. 
   </para>
   <para>
   On clicking <guilabel>No</guilabel>, the authentication process is repeated.
  </para>
  
      <para>
  This Main upload dialog is shown belows.
  </para>
  
  	
  <figure id="flickrexport-main-uploading-dialog">
      <title>The Main Uploading Dialog Preview</title>
      <mediaobject><imageobject>
        <imagedata srccredit="The Main Uploading Dialog Preview" fileref="flickrexportuploaddialog.png"/>
      </imageobject></mediaobject>
  </figure>
  
  <para>
  The <guilabel>Add Photos</guilabel> button should be clicked once user has set in the other options in the dialog. On clicking this button user a image selector dialog opens up, user can select the photos he wants to upload and click ok. On clicking ok the image uploading starts.
  </para>
  

  <para>
  The <guilabel>Tags</guilabel> field can be filled with a series of words (comma separated) which will be assigned as tags to the images uploaded.
  </para>
  
  <para>
  The <guilabel>Public</guilabel>, <guilabel>Friends</guilabel>, and <guilabel>Family</guilabel> Checkbox can be checked to have appropriate access permission on the images you upload. By default the images upload are private.
  </para>
  
  <para>
  If the <guilabel>Resize photos before uploading</guilabel> option is selected, the photos will be resized before uploading. The values will be read from the <guilabel>Maximum dimension</guilabel> combobox.
  </para>
  
  <para>
  The <guilabel>Maximum Dimension</guilabel> combobox can be used to adjust the maximum height to which the photos will be resized before uploading. The width calculation will be done so as to have the aspect ratio conserved.
  </para>
  
 <figure id="flickrexport-uploading-progress-dialog">
      <title>The Uploading Progress Dialog Preview</title>
      <mediaobject><imageobject>
        <imagedata srccredit="The Uploading Progress Dialog Preview" fileref="flickrexportuploading.png"/>
      </imageobject></mediaobject>
  </figure>
  <para>
 User can click <guilabel>Cancel</guilabel> button to abort the uploading of photos.
</para>

<para>
Finally user can view the uploaded photos by visting <ulink url="http://www.flickr.com">Flickr</ulink> website.
</para>
</sect1>

</chapter>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: ts
End:
-->
