Module:Bluesky RSS Feed

Documentation for this module may be created at Module:Bluesky RSS Feed/doc

local capiunto = require 'capiunto'
local p = {}
function p.main(frame)

local args = frame:getParent().args
local posts = {}
local searchTerms = {}

-- These are the search terms as defined in the template.
if args.term1 or args.term2 or args.term3 then
	searchTerms[1] = args.term1
	searchTerms[2] = args.term2
	searchTerms[3] = args.term3
else 
-- If no search terms, then the search terms array is left blank so it'll match everything.
	searchTerms = {""}
end

-- We use externaldata.getWebDate to obtain XML format data from the RSS feed at the URL defined by the user.
local rss = mw.ext.externaldata.getWebData {
    url = args.url
  , data = {pubDate = 'pubDate', description = 'description', link= 'link'}
  , format = 'xml'
}

-- We iterate over every post found in the RSS feed, in chronological order - hence ipairs.
for k, v in ipairs(rss) do

-- We need description, publish date AND link to know that it's a post. Additionally, k has to be more than 1 as the very first post to pop up in an RSS feed is the user bio which is not an actual post.

	if v["description"] and v["pubDate"] and v["link"] and k > 3 then
-- Search over every search term in the search terms to make sure a post contains that term.
		for a, b in pairs(searchTerms) do
			if string.find(v["description"],b) then
-- We bundle up the information into template form via the frame:expandTemplate method - the "Bluesky RSS Feed Row" template, to be precise - and put it into an incremental table which will later be expanded in full.
				table.insert(posts, frame:expandTemplate{title = 'Bluesky RSS Feed Row', args = {description = v["description"], pubDate = v["pubDate"], link=v["link"]}})
			end	
		end
	end
end

-- Table.concat to move it from Lua table form to a form the wikitext can use.
return table.concat(posts,"")


end

return p