Module:ServicesList

From MaRDI portal
Revision as of 17:46, 20 November 2024 by Tconrad (talk | contribs)

Documentation for this module may be created at Module:ServicesList/doc

-- Required module containing helper methods
local helper = require('Module:HelperMethods')

-- Required modules for SPARQL queries and HTML table generation
local sparql = require('SPARQL')
local mwHtml = require('mw.html')

-- Main table to hold all functions
local p = {}

function p.convertJsonToHTMLCards(jsonResults)
    local resultsHTML = ""
    
    if jsonResults and jsonResults.results and jsonResults.results.bindings then
        local bindings = jsonResults.results.bindings
        for i = 0, #bindings do
            local binding = bindings[i]
            
            -- Extract fields from the bindings
            local name = binding.name and binding.name.value or "Unnamed Service"
            local maintainer = binding.maintainer and binding.maintainer.value or "Unknown maintainer"
            local description = binding.description and binding.description.value or "No description available."
            local link = binding.item and binding.item.value:gsub("entity/Q", "wiki/Service:") or "#"
            local imageName = binding.icon and binding.icon.value or "Persona emma.jpg" -- Default placeholder image
            -- Extract only the "File:..." portion from the URL
			imageName = imageName:match("File:.*") or imageName
            local image = "[[" .. imageName .. "|100px|left]]"

            -- Build individual card HTML
            resultsHTML = resultsHTML .. string.format([[
                <div class="card" style="border: 1px solid #ddd; border-radius: 5px; margin: 10px; padding: 15px; display: flex; align-items: flex-start; position: relative;">
					<div style="position: absolute; top: 10px; right: 10px; padding: 5px 10px; ">
                        %s
                    </div>
                    %s 
                    <div>
                        <h3 style="margin: 0 0 10px 0;">[%s %s]</h3>
                        <p style="margin: 0;">%s</p>
                    </div>
                </div>
            ]], maintainer, image, link, name, description) 
        end
    end

    return resultsHTML
end

-- Function to build the list
function p.buildServiceList(frame)
	
    -- Constructing the SPARQL query with dynamic entity target1
    local sparqlQuery = [[
PREFIX wdt: <https://portal.mardi4nfdi.de/prop/direct/>
PREFIX wd: <https://portal.mardi4nfdi.de/entity/>

SELECT ?item ?name ?maintainer ?icon ?description
WHERE { 
  ?item wdt:P1460 wd:Q6503324 .
  ?item rdfs:label ?name .
  ?item wdt:P19 ?maintainer_url .
  ?maintainer_url rdfs:label ?maintainer .
  ?item wdt:P1640 ?icon .
  ?item wdt:P1459 ?description 
}
    ]]
    
    -- mw.log( sparqlQuery )
    
	-- Executing the SPARQL query and retrieving results in JSON format
	local jsonResults = sparql.runQuery(sparqlQuery)
	
	-- mw.logObject(jsonResults)

	-- Handle error in SPARQL query execution
	if jsonResults and jsonResults.error then
    	mw.log("Error in SPARQL query: " .. tostring(jsonResults.error))
    	return nil
	end

	if not jsonResults then
        return "Could not fetch data."
	end
	
	if helper.countElementsInBindings(jsonResults.results.bindings) == 0 then
        return "No records found."
	end

	local serviceList = p.convertJsonToHTMLCards(jsonResults)
	
    return serviceList
end

-- Return the created html table
return p