FlickrImport /

Filename Size Date modified Message
FlickrImport
23 B
5.8 KB
5.5 KB
********************************************************************************

                            FlickrImport

********************************************************************************

Import your Flickr stream into your Pixelpost photoblog.

Project Page : http://bitbucket.org/seza/flickrimport/wiki/Home


INSTALL:
================================================================================
1. Upload the folder "FlickrImport" and the file "admin_FlickrImport.php" on
   your "addons" Pixelpost folder.

2. Go to your Pixelpost admin panel > addons. Switch FlickrImport to ON.

3. Go to your Pxelpost admin panel > options > FlickrImport.

4. Make the authorization good.

5. Choose your options and select the photosets to sync.

6. Save your options

7. Click on the "Sync" button (be carefull to time execution exedeed ! on first
   sync) or add the sync script to your crontab (safe).

8. Enjoy !


HOW IT WORKS:
================================================================================

The Flickr API Key:
-------------------
This add-ons needs to connect on your Flickr account to retreive your photos.

By this way the connection of the addon need an authorization. This is possible
with the Flickr API key (see : http://www.flickr.com/services/api/).

The addons use it own key to make authorization, you can use your own key by
replacing them into the "FlickImport/common.php" file on line 54 and 55.

If you allready authorise the addon and change the key, the authorisation is
lost.

The authorization just need "read" authorization. The addon can't change
anything in your Flickr account.

Options and Synchronization:
----------------------------

*** THUMBNAIL ***

Importing thumbnail or not,
there is three options in your admin panel :

- "Flickr 100px size" : The addon download the thumbnail from flickr, this is
very fast but thumbnail is not square.

- "Flickr 50px size" : The addon download the thumbnail from flickr,
this is very fast but thumbnail is little and cropped.

- "Pixelpost thumbnail" : The addon let pixelpost generate the thumbnail,
this is longer but thumbnail correspond to your choice in your option admin
panel.

*** COMMENT ***

Importing the photo's comment,
there is five options in your admin panel :

- "Import and publish" : The photo's comment are downloaded and directly visible
on your photoblog.

- "Import" : The photo's comment are downloaded and but not directly visible
on your photoblog, you can allow or disallow in your admin each comment.

- "No Import" : The photo's comment are ignored.

- "Allow HTML tag" : The imported comments looks like Flickr comment. With images,
links etc...

- "Disallow HTML tag" : The imported comments have just text. This is usefull
for remove all blinking images in your Flickr comment for example.

*** PHOTOSET ***

The addon create all photoset you choose in the options admin panel in your
pixelpost as category.

If you rename the photoset on your flickr, the category is not renamed on your
pixelpost.

If you rename the category on your pixelpost, the link between the category and
the photoset is not lost.

If you remove the photoset on your flickr, the category is not deleted on your
pixelpost.

If you remove the category on your pixelpost but keep photoset in the sync
choice, it is all re-created on the next sync.

*** PHOTO ***

The addon always download the Original size of your photo because they always
dowloadable. This is why you can't choose the photo size in your options admin
panel.

If your delete a photo on your pixelpost admin, it's re-downloaded on the next
sync. Mass-delete on your pixelpost admin, The addon ignore that the photo was
deleted and did not download them on the next sync.

If a photo is in different photoset on your Flickr account, the photo is
imported in all corresponding category in your pixelpost.

If you remove a photo from a category but still present on the corresponding
photoset on Flickr, it is re-added on the next sync.

If you remove a photo from a photoset in your Flickr account, the photo still
added in the corresponding categorie on your pixelpost.

If you remove a photo from your Flickr account, the photo still
present in your pixelpost.


IMPORTANT:
================================================================================
This Pixelpost Addon include a modified part of Phlickr
produced by Andrew Morton <drewish@katherinehouse.com>
http://sourceforge.net/projects/phlickr/
which is under LGPL license.

Phlickr have actually a little bug concern the urls of thumbnails photo which
result in the impossibility to download. The version included here is little
modified to fix it. (see Phlickr_Photo::saveAs(), I add one optional argument
wich erase the generated url).

This Pixelpost addon is heavily inspired by Pixelpost Importr addon produced
by Christian Cueni <chrigu@trivialview.ch> (@link http://www.trivialview.ch)
which is under GPL license.


REQUIREMENTS:
================================================================================
- PHP GD library installed (if you use the pixelpost generate thumbnail option)
- PHP CURL library installed
- SimpleXml library installed


LICENCE:
================================================================================
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.