badpixxel-jekyll-flickr 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 775b9978bea89fbab21c5d1f23a06ff12615ea4d49c6d0b5572b8fba3674b597
+  data.tar.gz: 4252e5251b71c3c9f1e207379839872cff5676e06acb839d4a2dfeaf4a0a540d
+SHA512:
+  metadata.gz: '09d3ce1e39961e6abd96ef0b80c47947e998197d082bf3063a3b13f6a7085dbc6d575333aab313ca1b0705eb42662ccdcf386f3b6efd9a40b31bc06807e5df73'
+  data.tar.gz: 67c335d3d6b4895650f4f6943cc82fb7c756f9ee4d0910d1f08b23dcfdd37ab93b8ee31b202dd9a3eb68ba362acba2c4e9b3f6e197059a26ec7f21560a97d658

data/.gitignore

@@ -0,0 +1,56 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Ignore Byebug command history file.
+.byebug_history
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*

data/.travis.yml

@@ -0,0 +1,7 @@
+deploy:
+    provider:   rubygems
+    gemspec:    badpixxel-jekyll-flickr.gemspec
+    api_key:
+        secure: Bok1ntaSXwMZG+Lrd4MhzP3ksUnlgWrsNaaBUkuwuLYlGc4dfrkEKUDfrztRvtACgiK+/6WuKe6FWMJI/ifeWNi7MEXREgkqwjXFbXFXJWmlQ2reXNlxJGv4UqZGv1kmG2WnauS4hDKc9TqKA36HzJwXQpbP4KQNslvbfdPlI5ptwTshzAuSrznC6AWPvzirsBXwXag8Zu8MPlQd7MJWl3QNaOOOJgylsGOIgikaZAucnO5qPOlTANhSP6pqEhrbqozVxUWf43diFvMUcOMKwk0woyEb37TuPLg4y9IFQYqnzg/BiE24Hcb6tE/ibawclt8Kp6pReerBw+XN7lNfy7MnEA+b6B50mZM1GvQHs5MI63E361hVoi7BvJWHeBr/112Ozqv2Z9KFiGwVBOeYUabzQrzL3YkXoWzSD2DotOd1MGp8XDtOYmxrrM5a3WxuBhmxPPXYfC3yppckFwsgCFmaAkdBq3ES1+up4azRA/8rw4vZYSCtEsVV9t8xFsz8eMZCdQojqVf+J0egM9y9LR94QFpxasDATkMHJNuMO0X0nEAqqXA/NbYEP35RUmcZEkyQzUqJgDBBbaKeX2558qUndFXaT531Vs/qGfv0hvwLX6mYXCgeSOhJdkj2EDFFxnqJ7c2U3897RbnmPEEPgmEYHE+JeQSuhXSa0TL+K38=
+    on:
+        tags:   true

data/GemFile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+gemspec
+
+gem "jekyll", ENV["JEKYLL_VERSION"] if ENV["JEKYLL_VERSION"]
+
+install_if -> { Gem.win_platform? } do
+  gem "tzinfo", "~> 1.2"
+  gem "tzinfo-data"
+end

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 BadPixxel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,2 @@
+# jekyll-flickr
+A Jekyll plugin to embed Flickr Galreies & Photos in your Jekyll blog

data/badpixxel-jekyll-flickr.gemspec

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "lib/badpixxel-jekyll-flickr/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "badpixxel-jekyll-flickr"
+  spec.version       = Jekyll::FLICKR_VERSION
+  spec.authors       = ["BadPixxel"]
+  spec.email         = ["eshop.bpaquier@gmail.com"]
+  spec.summary       = "A Jekyll plugin to embed Flickr Sets & Photos in your Jekyll blog"
+  spec.homepage      = "https://github.com/BadPixxel/jekyll-flickr"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = ">= 2.3.0"
+
+  spec.add_dependency "jekyll", ">= 3.7", "< 5.0"
+  spec.add_dependency "flickraw"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "nokogiri", "~> 1.6"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/lib/badpixxel-jekyll-flickr.rb

@@ -0,0 +1,147 @@
+##
+## Embed Flickr photos in a Jekyll blog.
+##
+## Copyright (C) 2015 Lawrence Murray, www.indii.org.
+## Copyright (C) 2020 BadPixxel, www.badpixxel.com.
+##
+## 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.
+##
+require 'flickraw'
+require 'shellwords'
+
+module Jekyll
+    
+# Setup Flickr Plugin
+def self.flickr_setup(site)
+    # Complete Configuration with defaults Parameters
+    FlickrConfig.resolve(site)
+    # Load Flickr Contents from API
+    FlickrLoader.setup(site)
+    FlickrLoader.load(site)
+end
+
+# Get Flickr Photoset from Cache
+def self.flickr_get_photoset(site, photoset_name)
+    # Build Photoset Slug
+    slug = photoset_name.downcase.gsub(/ /, '-').gsub(/[^a-z\-]/, '')
+    # Build Photoset Path
+    photoset_file = File.join(site.config['flickr']['cache_dir'], "#{slug}.yml")
+    # Check if Photoset is Already in Cache
+    if !File.exists?(photoset_file)
+        return false
+    end
+
+    return Photoset.new(site, photoset_file)
+end
+
+class PhotoPost < Post
+    def initialize(site, base, dir, photo)
+        name = photo.date[0..9] + '-photo-' + photo.slug + '.md'
+
+        data = Hash.new
+        data['title'] = photo.title
+        data['shorttitle'] = photo.title
+        data['description'] = photo.description
+        data['date'] = photo.date
+        data['slug'] = photo.slug
+        data['permalink'] = File.join('/archives', photo.slug, 'index.html')
+        data['flickr'] = Hash.new
+        data['flickr']['id'] = photo.id
+        data['flickr']['url_full'] = photo.url_full
+        data['flickr']['url_thumb'] = photo.url_thumb
+        
+        if site.config['flickr']['generate_frontmatter']
+            site.config['flickr']['generate_frontmatter'].each do |key, value|
+                data[key] = value
+            end
+        end
+        
+        File.open(File.join('_posts', name), 'w') {|f|
+            f.print(YAML::dump(data))
+            f.print("---\n\n")
+            f.print(photo.gen_full_html)
+        }
+
+        super(site, base, dir, name)
+    end
+end
+
+class FlickrPageGenerator < Generator
+    safe true
+    
+    def generate(site)
+        Jekyll::flickr_setup(site)
+        cache_dir = site.config['flickr']['cache_dir']
+        
+        file_photosets = Dir.glob(File.join(cache_dir, '*.yml'))
+        file_photosets.each_with_index do |file_photoset, pos|
+            photoset = Photoset.new(site, file_photoset)
+            if site.config['flickr']['generate_photosets'].include? photoset.title
+                # generate photo pages if requested
+                if site.config['flickr']['generate_posts']
+                    file_photos = Dir.glob(File.join(photoset.cache_dir, '*.yml'))
+                    file_photos.each do |file_photo, pos|
+                        photo = Photo.new(site, photoset, file_photo, pos)
+                        page_photo = PhotoPost.new(site, site.source, '', photo)
+
+                        # posts need to be in a _posts directory, but this means Jekyll has already
+                        # read in photo posts from any previous run... so for each photo, update
+                        # its associated post if it already exists, otherwise create a new post
+                        site.posts.each_with_index do |post, pos|
+                            if post.data['slug'] == photo.slug
+                                site.posts.delete_at(pos)
+                            end
+                        end
+                        site.posts << page_photo
+                    end
+                end
+            end
+        end
+        
+        # re-sort posts by date
+        site.posts.sort! {|left, right| left.date <=> right.date}
+    end
+end
+
+class FlickrPhotosetTag < Liquid::Tag
+    def initialize(tag_name, markup, tokens)
+        super
+        params = Shellwords.shellwords markup
+        title = params[0]
+        @slug = title.downcase.gsub(/ /, '-').gsub(/[^a-z\-]/, '')
+    end
+    
+    def render(context)
+        site = context.registers[:site]
+        Jekyll::flickr_setup(site)
+        file_photoset = File.join(site.config['flickr']['cache_dir'], "#{@slug}.yml")
+        photoset = Photoset.new(site, file_photoset)
+        return photoset.gen_html
+    end
+end
+
+class FlickrFancysetTag < Liquid::Tag
+    def initialize(tag_name, markup, tokens)
+        super
+        params = Shellwords.shellwords markup
+        title = params[0]
+        @slug = title.downcase.gsub(/ /, '-').gsub(/[^a-z\-]/, '')
+    end
+    
+    def render(context)
+        site = context.registers[:site]
+        Jekyll::flickr_setup(site)
+        file_photoset = File.join(site.config['flickr']['cache_dir'], "#{@slug}.yml")
+        photoset = Photoset.new(site, file_photoset)
+        return photoset.gen_html_fancy
+    end
+end
+
+end
+
+Liquid::Template.register_tag('flickr_photoset', Jekyll::FlickrPhotosetTag)
+
+Liquid::Template.register_tag('flickr_fancyset', Jekyll::FlickrFancysetTag)

data/lib/badpixxel-jekyll-flickr/config.rb

@@ -0,0 +1,48 @@
+##
+## Embed Flickr photos in a Jekyll blog.
+##
+## Copyright (C) 2015 Lawrence Murray, www.indii.org.
+## Copyright (C) 2020 BadPixxel, www.badpixxel.com.
+##
+## 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.
+##
+
+module Jekyll
+
+FLICKR_CACHE_DIR = '_data/flickr'
+FLICKR_SIZE_FULL = 'Large'
+FLICKR_SIZE_THUMB = 'Small 320'
+
+class FlickrConfig
+
+	def self.resolve(site)
+	    # Setup Defaults Plugin Parameters
+	    if !site.config['flickr']['cache_dir']
+	        site.config['flickr']['cache_dir'] = FLICKR_CACHE_DIR
+	    end
+	    if !site.config['flickr']['size_full']
+	        site.config['flickr']['size_full'] = FLICKR_SIZE_FULL
+	    end
+	    if !site.config['flickr']['size_thumb']
+	        site.config['flickr']['size_thumb'] = FLICKR_SIZE_THUMB
+	    end
+	    if !site.config['flickr']['generate_posts']
+	        site.config['flickr']['generate_posts'] = false
+	    end
+	    if !site.config['flickr']['generate_photosets']
+	        site.config['flickr']['generate_photosets'] = []
+	    end
+	    if !site.config['flickr'].key?('use_cache')
+	        site.config['flickr']['use_cache'] = false
+	    end
+	    if !site.config['flickr'].key?('flush_cache')
+	        site.config['flickr']['flush_cache'] = false
+	    end
+    end
+
+end
+
+end

data/lib/badpixxel-jekyll-flickr/filters.rb

@@ -0,0 +1,59 @@
+##
+## Embed Flickr photos in a Jekyll blog.
+##
+## Copyright (C) 2015 Lawrence Murray, www.indii.org.
+## Copyright (C) 2020 BadPixxel, www.badpixxel.com.
+##
+## 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.
+##
+
+module Jekyll
+
+  module FlickrFilters
+
+  	# Get All tags for a Flikr PhotoSet
+    def flickr_ps_tags(photoset)
+        site = @context.registers[:site]
+    	Jekyll::flickr_setup(site)
+    	photoset = Jekyll::flickr_get_photoset(site, photoset)
+		if !photoset
+			return []
+		end
+
+    	return photoset.get_tags() 
+    end
+
+  	# Get Most Used tags for a Flikr PhotoSet
+    def flickr_ps_top_tags(photoset, count = 10)
+        site = @context.registers[:site]
+    	Jekyll::flickr_setup(site)
+    	photoset = Jekyll::flickr_get_photoset(site, photoset)
+		if !photoset
+			return []
+		end
+
+    	return photoset.get_top_tags(count) 
+    end
+
+
+  	# Get Flikr PhotoSet Photos
+    def flickr_ps_photos(photoset, max = false)
+        site = @context.registers[:site]
+    	Jekyll::flickr_setup(site)
+    	photoset = Jekyll::flickr_get_photoset(site, photoset)
+		if !photoset
+			return []
+		end
+
+    	return photoset.get_photos_array(max) 
+    end    
+
+
+  end
+
+end
+
+Liquid::Template.register_filter(Jekyll::FlickrFilters)

data/lib/badpixxel-jekyll-flickr/loader.rb

@@ -0,0 +1,84 @@
+##
+## Embed Flickr photos in a Jekyll blog.
+##
+## Copyright (C) 2015 Lawrence Murray, www.indii.org.
+## Copyright (C) 2020 BadPixxel, www.badpixxel.com.
+##
+## 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.
+##
+
+require 'flickraw'
+
+module Jekyll
+
+class FlickrLoader
+
+    attr_accessor :is_loaded
+
+    @@is_loaded = false
+
+	def self.load(site)
+
+		if @@is_loaded 
+	    	puts "Flickr: Photosets Already Loaded"
+			return
+		end
+
+	    # Setup Defaults Plugin Parameters
+	    if not self.is_ready(site)
+	    	puts "Flickr: Using Cached Photosets"
+	    	return
+	    end
+    	puts "Flickr: Update of Photosets cache"
+
+    	# Fetch list of Photosets
+        nsid = flickr.people.findByUsername(:username => site.config['flickr']['screen_name']).id
+        flickr_photosets = flickr.photosets.getList(:user_id => nsid)
+
+    	# Update All Photosets Cache
+        flickr_photosets.each do |flickr_photoset|
+            photoset = Photoset.new(site, flickr_photoset)
+    		puts "Flickr: Update Photosets #{flickr_photoset.title} (#{photoset.photos_from_cache} In Cache, #{photoset.photos_from_flickr} Loaded from Flickr)"
+        end
+
+        @@is_loaded = true
+    	puts "Flickr: Photosets cache updated"
+
+    end
+
+	def self.is_ready(site)
+	    # Check if Plugin Parameters Allow Cache Loading
+	    if site.config['flickr']['use_cache']
+	    	return false
+	    end
+	    if !site.config['flickr']['cache_dir']
+	    	return false
+	    end
+
+    	return true
+    end    
+    
+	def self.setup(site)
+
+        cache_dir = site.config['flickr']['cache_dir']
+        # Clear any existing cache if requested
+        if site.config['flickr']['flush_cache']
+	        if Dir.exists?(cache_dir)
+	            FileUtils.rm_rf(cache_dir)
+	        end
+        end
+        # Ensure Cache Dir Exists
+        if !Dir.exists?(cache_dir)
+            Dir.mkdir(cache_dir)
+        end
+        # Populate cache from Flickr
+        FlickRaw.api_key = site.config['flickr']['api_key']
+        FlickRaw.shared_secret = site.config['flickr']['api_secret']
+    end  
+
+end
+
+end

data/lib/badpixxel-jekyll-flickr/photo.rb

@@ -0,0 +1,183 @@
+##
+## Embed Flickr photos in a Jekyll blog.
+##
+## Copyright (C) 2015 Lawrence Murray, www.indii.org.
+## Copyright (C) 2020 BadPixxel, www.badpixxel.com.
+##
+## 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.
+##
+
+require 'flickraw'
+
+module Jekyll
+
+class Photo
+    attr_accessor :id, :title, :slug, :date, :description, :tags, :date_update, :date_update_str, :url_full, :url_thumb, :cache_file, :position, :from_cache
+    
+    def initialize(site, photoset, photo, pos)
+        self.from_cache = false
+        if photo.is_a? String
+            self.cache_load(photo)
+        else
+            self.flickr_load(site, photoset, photo, pos)
+        end
+    end
+    
+    def flickr_load(site, photoset, flickr_photo, pos)
+
+        # Check if Photo is Alreday in cache & not outdated
+        if !self.cache_outdated(photoset, flickr_photo)
+            photo = File.join(photoset.cache_dir, "#{flickr_photo.id}.yml")
+            self.cache_load(photo)
+            return
+        end
+
+        # init
+        self.id = flickr_photo.id
+        self.title = flickr_photo.title
+        self.slug = self.title.downcase.gsub(/ /, '-').gsub(/[^a-z\-]/, '') + '-' + self.id
+        self.date = ''
+        self.description = ''
+        self.tags = Array.new
+        self.url_full = ''
+        self.url_thumb = ''
+        self.cache_file = File.join(photoset.cache_dir, "#{self.id}.yml")
+        self.position = pos
+        self.date_update = flickr_photo.lastupdate
+        self.date_update_str = DateTime.strptime(flickr_photo.lastupdate, '%s').to_s        
+        
+        # sizes request
+        flickr_sizes = flickr.photos.getSizes(:photo_id => self.id)
+        if flickr_sizes
+            size_full = flickr_sizes.find {|s| s.label == site.config['flickr']['size_full']}
+            if size_full
+                self.url_full = size_full.source
+            end
+            
+            size_thumb = flickr_sizes.find {|s| s.label == site.config['flickr']['size_thumb']}
+            if size_thumb
+                self.url_thumb = size_thumb.source
+            end
+        end
+        
+        # other info request
+        flickr_info = flickr.photos.getInfo(:photo_id => self.id)
+        if flickr_info
+            self.date = DateTime.strptime(flickr_info.dates.posted, '%s').to_s
+            self.description = flickr_info.description
+            flickr_info.tags.each do |tag|
+                self.tags << tag.raw
+            end
+        end
+        
+        cache_store
+    end
+    
+    def cache_exists(photoset, flickr_photo)
+        # Check if Photo is Already in Cache
+        return File.exists?(File.join(photoset.cache_dir, "#{flickr_photo.id}.yml"))
+    end
+
+    def cache_outdated(photoset, flickr_photo)
+        cache_file = File.join(photoset.cache_dir, "#{flickr_photo.id}.yml")
+        # Check if Photo is Already in Cache
+        if !File.exists?(cache_file)
+            return true
+        end
+        # Load Cached Values
+        cached = YAML::load(File.read(cache_file))
+        if !cached["date_update"] or (cached["date_update"] != flickr_photo.lastupdate)
+            return true
+        end
+
+        return false
+    end    
+
+    def cache_load(file)
+        cached = YAML::load(File.read(file))
+        self.id = cached['id']
+        self.title = cached['title']
+        self.slug = cached['slug']
+        self.date = cached['date']
+        self.description = cached['description']
+        self.tags = cached['tags']
+        self.url_full = cached['url_full']
+        self.url_thumb = cached['url_thumb']
+        self.cache_file = cached['cache_file']
+        self.position = cached['position']
+        self.date_update = cached['date_update']
+        self.date_update_str = cached['date_update_str']
+        self.from_cache = true
+    end
+    
+    def cache_store
+        cached = Hash.new
+        cached['id'] = self.id
+        cached['title'] = self.title
+        cached['slug'] = self.slug
+        cached['date'] = self.date
+        cached['description'] = self.description
+        cached['tags'] = self.tags
+        cached['url_full'] = self.url_full
+        cached['url_thumb'] = self.url_thumb
+        cached['cache_file'] = self.cache_file
+        cached['position'] = self.position
+        cached['date_update'] = self.date_update
+        cached['date_update_str'] = self.date_update_str
+        
+        File.open(self.cache_file, 'w') {|f| f.print(YAML::dump(cached))}
+    end
+
+    def to_liquid
+
+        tags_hash = []
+        self.tags.each  do |tag|
+            tags_hash += [tag.hash]
+        end
+
+        return [
+            'id' => self.id,
+            'title' => self.title,
+            'date' => self.date,
+            'decription' => self.description,
+            'tags' => self.tags,
+            'tags_hash' => tags_hash,
+            'url_full' =>  self.url_full,
+            'url_thumb' =>  self.url_thumb,
+            'position' =>  self.position,
+            'date_update' =>  self.date_update,
+        ]
+    end    
+
+    def gen_thumb_html
+        content = ''
+        if self.url_full and self.url_thumb
+            content = "<a href=\"#{self.url_full}\" data-lightbox=\"photoset\"><img src=\"#{self.url_thumb}\" alt=\"#{self.title}\" title=\"#{self.title}\" class=\"photo thumbnail\" width=\"75\" height=\"75\" /></a>\n"
+        end
+        return content
+    end
+
+    def gen_thumb_html_fancy
+        content = ''
+        if self.url_full and self.url_thumb
+            content = "<a href=\"#{self.url_full}\" data-fancybox=\"photoset\"><img src=\"#{self.url_thumb}\" alt=\"#{self.title}\" title=\"#{self.title}\" class=\"img-fluid thumbnail\" /></a>\n"
+        end
+        return content
+    end
+
+    def gen_full_html
+        content = ''
+        if self.url_full and self.url_thumb
+            content = "<p><a href=\"#{self.url_full}\" data-lightbox=\"photoset\"><img src=\"#{self.url_full}\" alt=\"#{self.title}\" title=\"#{self.title}\" class=\"photo full\" /></a></p>\n<p>#{self.description}</p>\n"
+            if self.tags
+                content += "<p>Tagged <i>" + self.tags.join(", ") + ".</i></p>\n"
+            end
+        end
+        return content
+    end
+end
+
+end

data/lib/badpixxel-jekyll-flickr/photoset.rb

@@ -0,0 +1,194 @@
+##
+## Embed Flickr photos in a Jekyll blog.
+##
+## Copyright (C) 2015 Lawrence Murray, www.indii.org.
+## Copyright (C) 2020 BadPixxel, www.badpixxel.com.
+##
+## 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.
+##
+
+require 'flickraw'
+
+module Jekyll
+
+class Photoset
+    attr_accessor :id, :title, :description, :date_update, :date_update_str, :slug, :cache_dir, :cache_file, :photos, :photos_from_cache, :photos_from_flickr
+    
+    def initialize(site, photoset)
+        self.photos = Array.new
+        self.photos_from_cache = 0
+        self.photos_from_flickr = 0
+        if photoset.is_a? String
+            self.cache_load(site, photoset)
+        else
+            self.flickr_load(site, photoset)
+        end
+        self.photos.sort! {|left, right| left.position <=> right.position}
+    end
+    
+    # Load Photoset from Flckr (if needed) 
+    def flickr_load(site, flickr_photoset)
+        self.id = flickr_photoset.id
+        self.title = flickr_photoset.title
+        self.description = flickr_photoset.description
+        self.date_update = flickr_photoset.date_update
+        self.date_update_str = DateTime.strptime(flickr_photoset.date_update, '%s').to_s
+        self.slug = self.title.downcase.gsub(/ /, '-').gsub(/[^a-z\-]/, '')
+        self.cache_dir = File.join(site.config['flickr']['cache_dir'], self.slug)
+        self.cache_file = File.join(site.config['flickr']['cache_dir'], "#{self.slug}.yml")
+        
+        # write to cache
+        if self.cache_outdated(flickr_photoset)
+            self.cache_store
+        end
+
+        # create cache directory
+        if !Dir.exists?(self.cache_dir)
+            Dir.mkdir(self.cache_dir)
+        end
+        
+        # photos
+        flickr_photos = flickr.photosets.getPhotos(:photoset_id => self.id, :extras => "date_taken, last_update").photo
+        flickr_photos.each_with_index do |flickr_photo, pos|
+            photo = Photo.new(site, self, flickr_photo, pos)
+            self.photos << photo
+            if photo.from_cache 
+                self.photos_from_cache += 1
+            else
+               self.photos_from_flickr += 1
+           end
+        end
+    end
+    
+    # Check if Photoset Cachge is Outdated
+    def cache_outdated(flickr_photoset)
+        # Check if Photoset is Already in Cache
+        if !File.exists?(self.cache_file)
+            return true
+        end
+        # Load Cached Values
+        cached = YAML::load(File.read(cache_file))
+        if !cached["date_update"] or (cached["date_update"] != flickr_photoset.date_update)
+            return true
+        end
+
+        return false
+    end    
+
+    # Load Photoset from Cache
+    def cache_load(site, file)
+        cached = YAML::load(File.read(file))
+        self.id = cached['id']
+        self.title = cached['title']
+        self.description = cached['description']
+        self.date_update = cached['date_update']
+        self.date_update_str = cached['date_update_str']
+        self.slug = cached['slug']
+        self.cache_dir = cached['cache_dir']
+        self.cache_file = cached['cache_file']
+        
+        file_photos = Dir.glob(File.join(self.cache_dir, '*.yml'))
+        file_photos.each_with_index do |file_photo, pos|
+            self.photos << Photo.new(site, self, file_photo, pos)
+        end
+    end
+
+    # Store Photoset in Cache
+    def cache_store
+        cached = Hash.new
+        cached['id'] = self.id
+        cached['title'] = self.title
+        cached['description'] = self.description
+        cached['date_update'] = self.date_update
+        cached['date_update_str'] = self.date_update_str
+        cached['slug'] = self.slug
+        cached['cache_dir'] = self.cache_dir
+        cached['cache_file'] = self.cache_file
+        
+        File.open(self.cache_file, 'w') {|f| f.print(YAML::dump(cached))}
+    end
+
+    # Get List of Most used tags    
+    def get_top_tags(count)
+        # Build List of tags [ "tag" => count ]
+        all_tags = {}
+        self.photos.each do |photo|
+            photo.tags.each do |tag|
+                if all_tags.has_key?(tag)
+                    all_tags[tag] += 1
+                else
+                    all_tags[tag] = 1
+                end
+            end
+        end
+        # Sort & Filter tags
+        sorted_tags = all_tags.sort_by {|_key, value| value}.reverse.first(count).to_h
+        # Build Hashed Tags List
+        hashed_tags = []
+        sorted_tags.each do |tag_str, count|
+            hashed_tags += [ "tag" => tag_str, "hash" => tag_str.hash, "count" => count ]
+        end
+
+        return hashed_tags
+    end
+
+    # Get List of All Photoset Tags    
+    def get_tags()
+        # Build List of tags [ "tag" => count ]
+        all_tags = {}
+        self.photos.each do |photo|
+            photo.tags.each do |tag|
+                if all_tags.has_key?(tag)
+                    all_tags[tag] += 1
+                else
+                    all_tags[tag] = 1
+                end
+            end
+        end
+        # Build Hashed Tags List
+        hashed_tags = []
+        all_tags.each do |tag_str, count|
+            hashed_tags += [ "tag" => tag_str, "hash" => tag_str.hash, "count" => count ]
+        end
+
+        return hashed_tags
+    end      
+
+    # Get List of All Photoset Photos   
+    def get_photos_array(max = false)
+        # Build List of Photos [ "tag" => count ]
+        if max != false 
+            photos = self.photos.first(max)
+        else
+            photos = self.photos
+        end
+
+        collection = []
+        photos.each do |photo|
+            collection += photo.to_liquid
+        end
+
+        return collection
+    end 
+
+    def gen_html
+        content = ''
+        self.photos.each do |photo|
+            content += photo.gen_thumb_html
+        end
+        return content
+    end
+
+    def gen_html_fancy
+        content = ''
+        self.photos.each do |photo|
+            content += photo.gen_thumb_html_fancy
+        end
+        return content
+    end 
+end
+
+end

data/lib/badpixxel-jekyll-flickr/version.rb

@@ -0,0 +1,3 @@
+module Jekyll
+	FLICKR_VERSION = '0.0.1'
+end

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification
+name: badpixxel-jekyll-flickr
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- BadPixxel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-03-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jekyll
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.7'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.7'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: flickraw
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- eshop.bpaquier@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- GemFile
+- LICENSE
+- README.md
+- badpixxel-jekyll-flickr.gemspec
+- lib/badpixxel-jekyll-flickr.rb
+- lib/badpixxel-jekyll-flickr/config.rb
+- lib/badpixxel-jekyll-flickr/filters.rb
+- lib/badpixxel-jekyll-flickr/loader.rb
+- lib/badpixxel-jekyll-flickr/photo.rb
+- lib/badpixxel-jekyll-flickr/photoset.rb
+- lib/badpixxel-jekyll-flickr/version.rb
+homepage: https://github.com/BadPixxel/jekyll-flickr
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.6
+signing_key: 
+specification_version: 4
+summary: A Jekyll plugin to embed Flickr Sets & Photos in your Jekyll blog
+test_files: []