API v1 docs gone since Atlas migration to Aurora
Link for API v1 documentation used to point at this Classic instance at devdocportal.khoros.com (which I think used to be pointing at the same Classic instance that community.khoros.com ran on): https://devdocportal.khoros.com/t5/Community-API-v1-Reference/bd-p/restv1docs?section=commv1&page=apiv1home Since the Aurora migration of Atlas two weeks ago accessing this URL just returns a "Cannot find community" generic error. When can we expect this v1 doc to be back? It's currently becoming a major blocker for a bunch of development initiatives I'm involved in.
Seeking Advice on Restricting Access to a posts to those who have the permalink.
Hi everyone, I’m facing a challenge in Khoros and could use some advice. I need to occasionally create specific posts and share permalinks via email with a customer base. However, we don’t want these posts to be accessible to random users browsing our community site. Most importantly, we do NOT want the root folder to be accessible, so that we can prevent users from accessing the repository of posts or easily gathering all the posts that we publish over time. Any suggestions on how to achieve this would be greatly appreciated! Thank you in advance. Fergal
TinyMceEditor is undefined
Hi, I have a simple custom component: <form id="pmUpdateForm"> <textarea rows="" cols="" id="pmUpdate"></textarea> </form> <@liaAddScript> ;(function($) { $(document).ready(function() { tinymce.init({ selector: 'textarea#pmUpdate', height: 150, menubar: false, plugins : "paste", paste_text_sticky : true, setup : function(ed) { ed.pasteAsPlainText = true; } }); }); })(LITHIUM.jQuery, LITHIUM.TinyMceEditor); </@liaAddScript> I added the above component into one of the quilts. After the SDK push I always see Uncaught ReferenceError: tinymce is not definederror. I know why this error occurs but w.r.t Khoros, I am not able to figure out where to look. There is no official documentation about tinyMceEditor in atlas on how to use it.
400/404 error on POST request
Hey, I'm trying to do my very first POST API call and currently getting stuck. I know there are other solutions for what I'm trying to do, but I'm also trying to learn something rather than straight up copying & pasting. <#assign boardID = coreNode.id /> <button id="subscribe">Subscribe</button> <@liaAddScript> (function($){ $(document).ready(function(){ $("#subscribe").on( "click", function() { $.ajax({ url: "/api/2.0/subscriptions", dataType: 'json', data: { "data":{ "type":"subscription", "target":{ "type":"board", "id":"blueprints" } } }, method: 'POST' }).done(function(response) { console.log('Success'); }).fail(function() { console.log('Fail'); }) }); }); })(LITHIUM.jQuery); </@liaAddScript> When I click my button on the page, I get a 404 error in the console: GET https://community-stage.blueprism.com/api/2.0/subscriptions?data%5Btype%5D=subscription&data%5Btarget%5D%5Btype%5D=board&data%5Btarget%5D%5Bid%5D=blueprints 404 (Not Found) I assume I'm doing something wrong, but I can't figure out what. I've tried subbing the variable for the ID of the board too and the URL is the same, with the same 404 error. The only thing that's sprung to mind is that the API's don't work with the CNAME and I need to use the original domain for our staging site? Thanks in advance.How do I get the article ID in Freemarker in a TkbArticle?
This is Community Classic. I'm trying to write a component to display something from a hidden field (canonical_url) while on the page of a TkbArticle. It doesn't appear that either page.context.message.id or env.context.message.id work in anything Tkb related. What other options do I have to retrieve this information in the context of the page itself?Online User Count is Completely Wrong
I'm trying to get an accurate count of online users and it's quite obvious the count is completely wrong just by looking at the results I'm encountering on my staging environment. The LIQL query used is fairly simple: SELECT count(*) FROM users WHERE online_status='online' Given the number of people who access our staging server, I would expect the result of this to be a low single digit number. Instead, I got a result of over 30 users. So I dug into the API results: SELECT login,last_visit_time FROM users WHERE online_status='online' The results list users with last visit times from 2020 and 2021 as well as users from earlier in 2022 that I know for a fact aren't online. How is Khoros defining an "online user" here? Is the behavior I'm seeing a bug or expected behavior?Community Text - First Name Text Key
In Studio > Text Editor > Community TextI want to update the text-key general.welcome = Welcome back, {0}! To something like: general.welcome = Welcome back, ${profile.name_first}! But I don't know the text-key for the First Name in a user's Personal Information setting. Currently we are using general.welcome = Welcome back, {0}! And {0} is their username. We would like to personalize the message with their first name instead of their username. Does anyone know what text-key I can use to pull a users first name from their personal information / settings / profile? Thank you! DaveUrgent: Case Sensitivity w/ SSO
Our people system changed (salesforce, workday, whatever), and several users are saying "It's asking me to create a username!" Turns out: the OLD people system passes parikshita.sahoo@duckcreek.com The NEW people system passes Parikshita.Sahoo@duckcreek.com Apparently Khoros sees these as DIFFERENT users (due to capitalization changes). I submitted a support ticket, but the response indicated it's going to take a bunch of back & forth to help them recreate this thing. Which leads me to straight up ask you all -Has anyone else ran into case sensitivity issues before? In collaboration with our IAM team, I have a "plan" but it's not an easy one (transform to lowercase on the B2C front, and simultaneously batch some Khoros API calls to change all users' SSO IDs to lowercase. But it seems outright silly that Khoros cares about case sensitivity. Has anyone solved this before? Is there a checkbox I'm missing?Aurora Storybook - Component Library
Hi All🤙 I'm not seeing an Aurora specific Developer Discussion board so excuse me if I've posted this in the wrong section. Might be an idea to have a dedicated area🤔 I seem to recall early on seeing in presentations a Storybook for Aurora that let you navigate all the UI components that its made up of? I've hunted around and can't seem to find anything. Do we have access to a Storybook or Component Library that designers can use to review all the OOTB UI components, buttons, cards etc including what configurable states and options each UI might have. This would make designing unique layouts and custom page much easier and also ensure we adopt the global UI components (where possible) rather than creating our own bespoke versions. LarryI😉 Thx Chris
Subscription for Moderation Approved Event
Hello, Is there any subscription related to the moderation approved event, similar to the message event subscription we already have? We have a requirement where a specific set of code should be executed when a message is approved from moderation. Thanks in advance.2) Which Way is FRT Calculated? (topic or reply?). **EDIT: Appears to be Topic?? Details added:
In Community Analytics, is First Response Time calculated like: Select all TOPICS started in January, and calculate their FRT, ..or.. Select all FIRST REPLIES posted in January, and calculate their FRT --- **UPDATE:** History: A year ago, we noticed avg_thread_response_time seems to be returning "total thread response time." So, my brilliant coworker Kenton wrote a hardcore freemarker function to calculate the average. And it OFTEN aligns w/ Community Analytics: I mean, that's dang good. But leaves a few questions that led to a bit of a WTF moment. (friendly WTF moment.. just trying to wrap my head around the FRT stuff): Why are some boards really far off? (so, I investigated...) ... Looking into our internal Policy forum - System Average Response Time (minutes) Community Analytics 1,366 Kenton's Whizbang FRT Function 5,426 Community Analytics Export: (SS below) 5,426 🧐 Here's the CSV export from Community Analytics: The yellow stuff verifies Kenton's "Only get July's Topics" approach, which starts by getting all TOPICS in that date range: <#local topics_query = "select replies, post_time from messages where board.id = '${board_id}' AND depth = 0 and replies.count(*) > 0 and post_time > ${start} and post_time < ${end} limit 5000" /> And don't forget, this aligns with almost every other CA stat...😅 Let's talk about theBlue Box (old topics that received replies during this time period): I propose those in the blue box(where replies == 1) should be factored into the Average FRT... BUT, that would INCREASE the Average FRT to 26,617. See? Let's update the table: System Average Response Time (minutes) Community Analytics 1,366 Kenton's Whizbang FRT Function 5,426 Community Analytics Export: (July topics only) 5,426 Community Analytics Export: (Including blue where replies == 1) 26,617 🤦 Where is Community Analytics getting 1,366 from? (I feel like I'm missing something obvious). Unsettled, I tried a theory that got me CLOSE but not exact like previous calculations... 👉THEORY: Maybe CA is excluding the extremes? I tried a lot of exclusion scenarios, and the closest I got was this: Exclude everything above 10,000 mins, and Exclude everything below 20 mins This got me pretty close - . 1,344 minutes is close to 1,366 minutes, but is very unconvincing. Back to the table: System Average Response Time (minutes) Community Analytics 1,366 Kenton's Whizbang FRT Function 5,426 Community Analytics Export: (July topics only) 5,426 Community Analytics Export: (Including blue where replies == 1) 26,617 Community Analytics Export: (but ignoring under 20mins and above 10k) 1,344 😂 So what's right? I vote 26,617 is accurate. It's the only one that truly considers all first replies. Doesn't the "Topics" approach create a situation where many first replies are never considered? Those in the blue box weren't considered in their respective months b/c they didn't have replies. And they are certainly not being considered now. -- even if I retrospectively run the report from April 2023, I get an Average FRT of 743 minutes, which is clearly not considering that 678,620 minute response time ... But, I think the 5,426 is more relevant for day-to-day reporting and decision making. While it's technically inaccurate (e.g, because it leaves out topics that are asked in March but answered in April), it avoids the extreme outliers that slip through the cracks and skew the picture. What do you think? Is there like some simple button I'm forgetting to push? 🤪1) is AVG_thread_response_time actually TOTAL thread response time? 😬 😱
I speculated about this a year ago, but this week my intrigue was brought back to life. ...so I did some testing... Using: /restapi/vc/boards/id/PolicyInternal/metrics/name/avg_thread_response_time, I’m getting 64851 minutes for July 1st – 26th: ?date_start=2024-07-01T00:00:00&date_end=2024-07-26T23:59:59 = 64851 minutes That seems way off base…. To test, I split that in half: ?date_start=2024-07-01T00:00:00&date_end=2024-07-13T23:59:59 = 28847 minutes ?date_start=2024-07-14T00:00:00&date_end=2024-07-26T23:59:59 = 36004 minutes 🥁… 🥁 … 🥁 28847 + 36004 = 64851 Is anybody (or nobody) else running into this? Is this luck? Am I using the metrics API wrong?Possible? Display 30-day FRT on a Board Component?
Our Board Oversight teams would like a component on their boards that displays the First Response Time (FRT) average over the past 30 days. While I realize I can grab this in Community Analytics, and I also am comfortable around the API... I'm a bit of a newbie when it comes to grabbing time-constrained data via the API Here's the board component with the line in question: <#if userHasApplicableRole> <#assign frt = [30_DAY_BOARD_FRT_AVG] /> <#-- this --> <div class="dc-boardwidget-FRT" title="FRT 30-day average"> <i class="fa-regular fa-reply-clock"></i> <span>${frt}</span> </div> </#if> Is this possible with the API? wkd-oliverCan I find the count of unanswered topics (for a given forum) for a certain date?
We're starting to track "unanswered topics" as a KPI. Is it possible to grab this historically? (e.g.: "For each forum, return the count of unanswered topics on February 1st, 2024") I'm okay with a bit of trickery, but am currently at a loss. Any pointers would be appreciated!Refresh Token not returned from accessToken endpoint
For the Community API, Using the OAuth 2.0 grant flow, we're able to successfully retrieve an access token from the /api/2.0/auth/accessToken endpoint. However, in it's response the refresh_token field is not returned. As a result we are then unable to refresh the token via /api/2.0/auth/refreshToken. Here is the response we're getting from /api/2.0/auth/accessToken: { "status":"success", "message":"", "http_code":200, "data":{ "access_token":"REDACTED", "lithiumUserId":"REDACTED", "token_type":"bearer", "userId":"REDACTED", "expires_in":3600 } }Remove unused data from lia-scripts-body-min.js?
Hi all, Long time no see. We are optimizing the loading times of our Community pages and looking at it from different angles. We allready removed some monitoring-scripts that our Corporation injects on all domains. We have optimized some components. One of the tools is doing a performance test in Edge/Chrome via Lighthouse. This points out a lot of things, there are a few issues with image sizes being full res when it is not needed. Lighthouse also says the main Khoros Javascript file is very large (Javascript file of 4,3MB) of wich 75% ar unused bytes.It concerns script:/t5/scripts/D35BF2B1BD3AD224F7D497E86C86DB4F/lia-scripts-body-min.js We are not sure if this has a big impact in the real world. It seems worth it to cut out the 3MB of data transfer. We asked support, support says it is an OOTB thing. This implies the thing is not broken and they cannot put resources into it.They refer to this discusion board. So, do you guys know if unused bytes in a Javascript file (specifically lia-scripts-body-min.js) is an issue? And if this is something our vendor could fix or should fix?Guidance on Removing URL Fragments in Khoros Community Classic
Hello everyone, Google recently provided feedback indicating that using fragments in URLs is not considered a best practice. As a result, I've been asked if we can eliminate fragments on the server side. For example, consider the following URL: https://community.khoros.com/t5/Khoros-Communities-Aurora/Analytics-Support-for-3rd-party-tools-eg-Google-Analytics-Custom/m-p/763108#M246 While Aurora does not use fragments, which is great, I am curious about potential mitigation strategies for those still using Classic. As far as I understand, and I admit I'm not a developer, the only way to address this issue is on the client side via the Page Initialization Script. Is there a possibility to handle this on the server side, perhaps through Khoros Professional Services? Additionally, I have concerns about the impact of removing fragments. If we were to implement a solution, would it prevent users from linking to specific replies? While this may improve SEO, it could also affect core functionality. Any thoughts/feedback is welcome as I'm a bit stumped hereEmojis in email subject?
Hello and good day! Is adding emojis in email subject/body even possible? I tried so so many ways, read a ton of articles, but every time Studio editor replaces an emoji with a question mark (🥷 becomes "?"). Doing it from SDK also doesn't work. Has anyone explored this and whether even it's possible?Create URL for Private Message to Multiple Recipients
Hi I can use this URLhttps://community.khoros.com/t5/notes/composepage/note-to-user-id/106204 to open a private message page with one recipient already selected. Is there a way out of the box to do this for multiple recipients using a list of user ids (or any identifier username is fine as well)? Also, would it be possible to have the broadcast message checkbox already checked as well? Lastly, is there a list somewhere of URL parameters that can be used with this URL? Thanks!remove comments from Q&A
Hi, We are exploring the Q&A option to see if it fits our needs. When I check the out-of-the-box QA question page (qaq-p) in studio, I can see that the main content is all non-contract compontens. <add to="main-content"> <component id="question-view"/> <component id="solutions-with-toggle"/> <component id="answer-list-with-toggle"/> </add> Does anybody know if these non-contract components take parameters to tweak them further? eg. hide the comments section disable the answer button remove the custom tagging ... ThanksHow to Setup Git repository for deployments in Khoros Classic
Hello, We're using Khoros Classic and would like to implement a Git setup for our deployments. Could you provide documentation on how to set up Git for deployments in Khoros Classic? Additionally, it would be helpful to know which features like components and macros are supported through Git, as well as a list of unsupported items such as administrative items. Thank you.Add anonymous functionality to creating posts or comments
Hi there We need to add the ability to publish posts and comments as anonymous (optional) for registered users in the community. Can this be implemented using the built-in functionality (since now there use built-in components when creating a post or comment) or do we need to create a custom component for this and use the REST API. ThanksUsing user_context.read as a constraint on messages collection
Hi all, We are wanting to use a Liql Query like 'Select * from messages where user_context.read = false and board.id='boardid'' Essentially what we want to do is be able to list only unread messages for the user in a give board but I cant find a way to do that, any suggestions?
subscriptions count at article level
Hello, I am attempting to retrieve subscriptions count at the article level using the following SQL query: SELECT * FROM subscriptions WHERE target_type = 'article' AND target_id = '8223'; Although the response indicates success, I'm not receiving any subscription lists. Could someone please review the query and provide guidance on what might be incorrect? I subscribed the article even after it just returning nothing PageType :TkbArticlePage response { "status" : "success", "message" : "", "http_code" : 200, "data" : { "type" : "subscriptions", "list_item_type" : "subscription", "size" : 0, "items" : [ ] }, "metadata" : { } Thank you in advance for your assistance.
Any way to store an incoming JSON in the liql database?
We have a third-party API which will make certain POST calls to send JSON data over to Community. Do we have an option to store this JSON in the db? The workaround I was thinking of was to post all this data as messages in a certain board ( forum/tkb ), but the data coming in might not be structured well for user-firendly display.Requesting feedback on our Dev Lab!
Hey all, hope you enjoyed the Dev Lab we held last week! I wanted to ask for open feedback - whether positive or negative - about your experience. What did you like? What should we do different next time? Posting here for everyone to respond, but tagging in some folks I know attended:shavetaskthometzryancjmpRyan_GilmoreDRaynorcjdingerNatkinsonAkenefickLiefStanGromerdfeaseyCarolineSMichelle_LynnRobertTetissonallensmith81Malcolm-MsteffiatebayKev_BOBRIEN_PtywOHORBACHhim_varmaHow to change Post Page text keys based on the content type (eg, blog, forum, tkb) of that Post Page
Hello guys. I have a requirement where I needto change a specific text key on the Post Pages based on the content type (e.g., blog, forum, TKB) that the user will be creating by clicking on the "Create" button from any content type board. For example for a blog Post Page the button should say "Start a Blog". SC- 1. Is there any way it can be achieved by suffixing the text key with any already used parameter? I know for quilts we can use e.g. -@page:TkbPageas a suffix and it overrides the text key on that page. But as the post page uses the same quilt I want to know if there are any separate parameters for differentiating between them. 2. If I have to use freemarker then how can I use coreNode.nodeType for getting it's parent node and type or any other default parameter for achieving this? 3. If it is achievable by using JavaScript then what steps should be followed and would it be a good approach? Please let me know. Thanks in advance.How to Create a New Rank: Error Encountered
"While trying to create a new rank using the Ranking Formula, I'm encountering an error. The formula I'm using is: (logins >= 1) && (posts = 0) && (page_views = 0) && (net_kudos_weight_given = 0) && (net_kudos_weight_received = 0) && (accepted_solutions = 0) I'm using the following variables for likes: Likes given = 0 (kudos_events_given) Likes received = 0 (kudos_events_received) Can someone please help me identify what is wrong here?"
message id question
I have a question about message id I always 2 integer ids in my URL, eg: https://baord.com/t5/boardname/ThreadsSubject/m-p/1204122#M832222 the 2 numbers i have question is the 1204122 and 832222 I know on messages table, the ide is 1204122, so I can use select * from messages where id is 12041122 I know sometimes I see that number being call Thread id as well but how about the 832222 ? I see it referred as "message-id" in some url, too. For example: https://baord.com/t5/forums/replypage/board-id/boardname/message-id/832222/load-autosave/true so, where this 832222 id actually stored? which table? thanksany easy way to find post for today and yesterday...
Hi, i am tyring ton find out total new thread for today or yesterday using https://mycommunity/api/2.0/search?q=SELECT count(*) FROM%20messages%20where post_time>=2024-05-01T00:00:00.000-00:00 and post_time <= 2024-05-01T23:59:59.999-00:00 and depth = 0 is there any way to filter out post_time using by calling something like getdate() or for yesterday like getdate()-1? thanksHow can I get subscription counts of Products?
Hi all, When a user is on a Product page, they have the option to subscribe to that Product. I'm simply trying to get a count of how many users have subscribed to a given Product. Is this possible? If so, how? I've found the subscription API, but it only ever returns subscriptions for me, not for all users. In the Community API v1 I've also found how to get subscription stats for Boards, but it appears that that endpoint is missing for Products. Subscriptions to Products events are also not part of the Bulk Data API. Am I missing something? Thanks for any info, LeeHow to get the total number of many kinds of views for a unique user? IE. Topic View...
How can I get the total topic number and total reply number for a unique user? May I get help from some one that how can I get the numbers of some kinds of views for a unique user? I want to get the total numbers ofBoard View, Topic View, Accepted Solution View, Article View, Idea View, Blog Read and Comment. Could you provide the logic and which APIs could I use to get those numbers?Aurora SDK install via NPM
LarryI Was excited to see the new SDK via NPM but I hit some problems I wanted to share with you. The documentation says you support NodeJS 16 and 17. With Node 17.9.1 installed you get errors when you try to install the sdk, specifically: sudo npm install khoros-aurora-sdk --no-fund npm WARN config global `--global`, `--local` are deprecated. Use `--location=global` instead. npm WARN EBADENGINE Unsupported engine { npm WARN EBADENGINE package: '@typescript-eslint/eslint-plugin@6.8.0', npm WARN EBADENGINE required: { node: '^16.0.0 || >=18.0.0' }, npm WARN EBADENGINE current: { node: 'v17.9.1', npm: '8.11.0' } npm WARN EBADENGINE } npm WARN EBADENGINE Unsupported engine { npm WARN EBADENGINE package: '@typescript-eslint/parser@6.8.0', npm WARN EBADENGINE required: { node: '^16.0.0 || >=18.0.0' }, npm WARN EBADENGINE current: { node: 'v17.9.1', npm: '8.11.0' } npm WARN EBADENGINE } npm WARN EBADENGINE Unsupported engine { npm WARN EBADENGINE package: '@typescript-eslint/scope-manager@6.8.0', npm WARN EBADENGINE required: { node: '^16.0.0 || >=18.0.0' }, npm WARN EBADENGINE current: { node: 'v17.9.1', npm: '8.11.0' } npm WARN EBADENGINE } npm WARN EBADENGINE Unsupported engine { npm WARN EBADENGINE package: '@typescript-eslint/type-utils@6.8.0', npm WARN EBADENGINE required: { node: '^16.0.0 || >=18.0.0' }, npm WARN EBADENGINE current: { node: 'v17.9.1', npm: '8.11.0' } npm WARN EBADENGINE } npm WARN EBADENGINE Unsupported engine { npm WARN EBADENGINE package: '@typescript-eslint/types@6.8.0', npm WARN EBADENGINE required: { node: '^16.0.0 || >=18.0.0' }, npm WARN EBADENGINE current: { node: 'v17.9.1', npm: '8.11.0' } npm WARN EBADENGINE } npm WARN EBADENGINE Unsupported engine { npm WARN EBADENGINE package: '@typescript-eslint/typescript-estree@6.8.0', npm WARN EBADENGINE required: { node: '^16.0.0 || >=18.0.0' }, npm WARN EBADENGINE current: { node: 'v17.9.1', npm: '8.11.0' } npm WARN EBADENGINE } npm WARN EBADENGINE Unsupported engine { npm WARN EBADENGINE package: '@typescript-eslint/utils@6.8.0', npm WARN EBADENGINE required: { node: '^16.0.0 || >=18.0.0' }, npm WARN EBADENGINE current: { node: 'v17.9.1', npm: '8.11.0' } npm WARN EBADENGINE } npm WARN EBADENGINE Unsupported engine { npm WARN EBADENGINE package: '@typescript-eslint/visitor-keys@6.8.0', npm WARN EBADENGINE required: { node: '^16.0.0 || >=18.0.0' }, npm WARN EBADENGINE current: { node: 'v17.9.1', npm: '8.11.0' } npm WARN EBADENGINE } I had to drop back down to 16.20.2 to be able to successfully install the aurora SDK. When I run npm list I now get: `-- khoros-aurora-sdk@24.5.0-rc.0 Ok so fixed but looks like node 17 isn't supported. Next problem, it tells me to clone the repo from git, which I do. It then tells me to find .env.local file and edit it in a text editor. I have checked that hidden files are visible in file explorer but there is no file called .env.local.. What am I missing? The only files in the cloned repo are: 1. a directory called res which contains sub-directories [components,props,quilts,texts,themes] 2. a file called README.md
Developer Discussion
Connect with other developers working with the Khoros Development Platform4,690 Posts
