Developer Blog
News, tips, and stories about Khoros platform development and integration
Recent Content
change icons on Aurora
I want to change the kudos icon on Aurora to a heart instead of the thumbs up. I was looking to see if it is possible via the theme.json file but i can't find a lot of info except for the Id needed to change the header logo. Anybody tried this already or had some succes doing this?
Handlebars custom component not executing GraphQL query
I have been following along with the directions on this page to try to create a custom Handlebars component that executes a graphQL query and displays the results in simple HTML. My .hbs file references the query like this: {{#gql "privateUserStats" variables=(hash id=user.id)}} ... {{/gql}} I also have a .graphql query defined in queries/privateUserStats.query.graphql: query privateUserStats($id: ID!) { user(id: $id) { id login email firstName lastName email ... } topicsStarted: messages(constraints: {authorId: {eq: $id}, depth: {eq: 0}}) { totalCount }... } and I reference it in my component.json under the "graphql" block: "graphql": { "privateUserStats": "./queries/privateUserStats.query.graphql" } Despite this setup: The Handlebars rendered correctly user.id was available But the GraphQL query never fired — no network activity, no data returned, and no console errors Can someone help? I'm all out of ideas.
Custom component for group hubs
Hello, I built couple of custom components for connect.hyland.com, but until now I didn't need to know the current category id. I need to build a new component to improve the layout of our Group Hubs (default components are either "too much" or "not enough" or don't exist). I would need to get only the Group Hub description (not the one in admin, but the one that owners can edit) and the list of Group Hub owners. I searched the API documentation but I struggle with the start: in my component, how I can get the node id, or the group hub id in which this component will work?Using css in widget or styling out of the box components
I was wondering if it is possible to add a css file to a widget created in the designer. I know that this is possible when creating a handlebars component but when changing a widget in the code you can't add the css file as far as I can tell. I'm trying to create a component that is easily editable by our administrator, that's why I was thinking of using a widget created in designer. I don't know how easy or possible it is to add editable content in a handlebars or react component. If this is possible than that would also be an option. Anybody knows how to tackle this or where to find the correct information?Can somebody help me with session keys?
Hello, We'd like to connect one of our group hub with our Power BI report. We'd like to see the list of users synched automatically (it's a hidden group hub, and whoever joins the group grabs a license automatically to our beta software too). So far it seems that Bulk API was not really helpful with that, but Search API would be a great fit. However, this is where we have our problem - it requires a session key, that we don't know how to get. We use SSO on our site (SAML), and I can't seem to find anything useful in the documentation (https://developer.khoros.com/khoroscommunitydevdocs/docs/search-api-overview)... Can somebody help me how to make this work? We're running on Classic currently. Thanks, NoémiAurora Email Templates
Hi everyone, I am new to GraphQL, so please forgive any silly questions here. I've successfully set myself up in Postman, and can retrieve email templates. I understand the documentation here about the process of updating a template, but I am hung up on viewing the HTML within each template so that I might edit that. My end goal, hopefully, is to be able to glean the variable for a post title within say, the Mentions template, and put that into the Subject of the email. So instead of "{User} mentioned you on {Community Title}" I would ideally have a subject that says "{User} mentioned you in the thread {Post Title}" I would also like to edit other pieces of other emails, but looking to cut my teeth on this one. Has anyone had success making a change like this on Aurora, and might be able to point me in the right direction? Thank you!Cannot successfully archive message via API v2
Has anyone been able to successfully archive a message using the Community API v2 POST call documented in the Developer Docs? I've tried several ways and can't seem to get it to work. For example: Using the restadmin directive <#assign response = restadmin("2.0", "/archives/archive", "POST", {"messageId": "32815"}) /> Status: ${response.status}<br /> Message: ${response.message}<br /> Data Keys:<br /> <#list response.data?keys as dataKey> - ${dataKey}<br /> </#list> Using the restBuilder directive <#assign archivePostCall = restBuilder() .method("POST") .path("/archives/archive") .body({"messageId": "32815"}) .admin(true) /> <#assign response = archivePostCall.call() /> Status: ${response.status}<br /> Message: ${response.message}<br /> Data Keys:<br /> <#list response.data?keys as dataKey> - ${dataKey}<br /> </#list> Both attempts above returned the following response: Status: error Message: Error generating JSON response. Data Keys: - getClass - validTemplateModelObject - toSerializedString - isValidTemplateModelObject - hashCode - equals - get - toString - class I tried performing the same operation via Python (as shown below) but the response is either a 400 or 500 error depending on whether or not I explicitly define the "content-type" header as "application/json" in my request. Attempt #1: Python 3.7.6 (tags/v3.7.6:43364a7ae0, Dec 19 2019, 00:42:30) [MSC v.1916 64 bit (AMD64)] on win32 >>> from khoros import Khoros >>> khoros = Khoros() >>> response = khoros.post('/api/2.0/archives/archive', {'messageId': '32815'}, return_json=False) >>> response <Response [400]> >>> response.text '{"status":"error","message":"A possible invalid request has been made. Make sure you are following the API spec and have used the correct URL, are included all required parameters and if a request payload is required you have included one.","data":{"type":"error_data","code":309,"developer_message":"","more_info":""},"metadata":{}}' >>> response.request.url 'https://REDACTED.com/api/2.0/archives/archive' >>> response.request.body '{"messageId": "32815"}' >>> response.request.headers {'User-Agent': 'python-requests/2.23.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive', 'li-api-session-key': 'REDACTED', 'Content-Length': '22'} Attempt #2: >>> response = khoros.post('/api/2.0/archives/archive', {'messageId': '32815'}, headers={'content-type': 'application/json'}, return_json=False) >>> response <Response [500]> >>> response.text '{"status":"error","message":"An unexpected error occurred.","data":{"type":"error_data","code":301,"developer_message":"Can not deserialize instance of java.util.ArrayList out of START_OBJECT token\\n at [Source: org.apache.catalina.connector.CoyoteInputStream@34f637da; line: 1, column: 1]","more_info":""},"metadata":{}}' >>> response.request.headers {'User-Agent': 'python-requests/2.23.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive', 'li-api-session-key': 'REDACTED', 'content-type': 'application/json', 'Content-Length': '22'} I was hoping I could do a network trace of the archival process in the web UI to see what the syntax should be, but it looks like a different UI-specific endpoint and form is used to perform the operation so I couldn't learn anything from it. Any help with this would be greatly appreciated. Thanks!
Featuring a topic in Khoros Classic
Hi all, I'm looking for a way to be able to feature a give topic via the REST API v2. I tried doing this in a test endpoint, <#assign feature_call = restBuilder() .method("PUT") .path("/messages/11577") .body({ "data": { "type": "message", "conversation": { "featured": true } } }) .admin(true) /> but it fails with the following error: { "status":"error", "message":"The following parameters, or the value passed in for them, are not valid: [featured].", "data":{ "type":"error_data", "code":404, "developer_message":"The parameter featured is not allowed in an 'update' call.", "more_info":"" }, "metadata":{} } I couldn't find anything in the REST API v1 either. Is there no way to actually feature a message via the API?
Featured Places
Release Notes & Updates
Review release notes and updates for all of our products! Select a tag to browse by product or resource type.Help & Support
Find solutions and support for Khoros productsSupport Information
Review general information about Khoros Support
Events & Webinars
Learn more about your Khoros solution with helpful webinars and special events
