Just started a new job and got introduced to Concrete CMS. While browsing the API reference at https://documentation.concretecms.org/api/, I noticed the search plugin offerings in Firefox. This stuff in <head>
:
<link rel="search"
type="application/opensearchdescription+xml"
href="https://documentation.concretecms.org/api/opensearch.xml"
title="ConcreteCMS API (9.1.1)" />
However, the href
s in the <link>
s are missing the API version number making the installation fail. That is also the case for the template
attribute in the <Url>
tag of the linked XMLs meaning that even if the plugin installation worked, the search wouldn’t.
So, the above should be changed to:
<link rel="search"
type="application/opensearchdescription+xml"
href="https://documentation.concretecms.org/api/9.1.1/opensearch.xml"
title="Concrete CMS API (9.1.1)" />
repeated for each supported version number and the linked opensearch.xml
s should be changed from:
<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" xmlns:referrer="http://a9.com/-/opensearch/extensions/referrer/">
<ShortName>ConcreteCMS API (9.1.1)</ShortName>
<Description>Searches ConcreteCMS API (9.1.1)</Description>
<Tags>ConcreteCMS API</Tags>
<Url type="text/html" method="GET" template="https://documentation.concretecms.org/api/search.html?search={searchTerms}&utm_source={referrer:source?}"/>
<InputEncoding>UTF-8</InputEncoding>
<AdultContent>false</AdultContent>
</OpenSearchDescription>
to something like:
<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/" xmlns:referrer="http://a9.com/-/opensearch/extensions/referrer/">
<ShortName>Concrete CMS API (9.1.1)</ShortName>
<Description>Searches Concrete CMS API (9.1.1)</Description>
<Tags>ConcreteCMS API</Tags>
<Url type="text/html" method="GET" template="https://documentation.concretecms.org/api/9.1.1/search.html?search={searchTerms}"/>
<InputEncoding>UTF-8</InputEncoding>
<AdultContent>false</AdultContent>
</OpenSearchDescription>
I was able to test the changes on a personal website and both the installation and subsequent search started working.