Skip to content
This repository has been archived by the owner on Feb 13, 2024. It is now read-only.

hyvor/hyvor-talk-react

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Deprecated

IMPORTANT ⛔️⛔️⛔️

This library and Hyvor Talk version 2 are now deprecated. Migrate to the new library and Hyvor Talk version 3.

Hyvor Talk - React

Add Hyvor Talk to React Apps

NPM

Install

npm install hyvor-talk-react

Library

This library includes two Components.

  1. Embed - To load Hyvor Talk embed
  2. CommentCount - To load comment counts for listing pages

Example

import React, { Component } from 'react'

import { Embed, CommentCount } from 'hyvor-talk-react'

class Article extends Component {
  render () {
    return (
      <div>
        <h1>Article Title</h1>

        <div className="comment-count-view">

          { /* Comment Counts */ }
          <CommentCount 
            websiteId={YOUR_WEBSITE_ID}
            id={WEBPAGE_IDENTIFIER} 
          />

        </div>
        
        <content>Your Article Here</content>

        { /* Load Comments now */ }
        <Embed 
          websiteId={YOUR_WEBSITE_ID}
          id={WEBPAGE_IDENTIFIER}
        />
      </div>
    )
  }
}

Embed Component

This component loads the comments iframe into your website and supports the following attributes.

  • websiteId - (int) (required) ID of your website. This ID is given to you when you register your website on Hyvor Talk. Visit console to find it or create new one.
  • id - (any) (optional) This is used to identify each web pages uniquely by Hyvor Talk. If you don't set it, the canonical URL will be used as the ID. If canonical URLs are not set URL of the page will be used without query params.
  • url - (string) (optional) You can explicitly set the URL of the page.
  • title - (string) (optional) Title of the page. If not set, document.title will be used.
  • loadMode - (string) (optional) Load Hyvor Talk on load, click, or scroll
  • clickId - (string) (optional) If load mode is click, set clickId to the ID of the button on your website
  • palette - (object) (optional) A palette object to set colors dynamically.
  • language - (string) (optional) Language code. See supported languages
  • sso - (object) (optional) Single sign-on object. See the documentation for more details. Note that to use SSO with React, you'll need to fetch the SSO details from the backend and render the component after that.
  • authorEmail - (string) (optional) Email of the author of the page
  • onEvent - (function) (optional) A callback to capture events. See events.

CommentCount

This component can be used to display comment counts on a listing page or a blog page itself.

Attributes:

  • websiteId
  • id - ID of the webpage (should be the same used to load comments)
  • mode - (string) (optional) Use mode="number" to display only the number of comments.
  • language - (string) (optional) Language code. See supported languages.

License

MIT © Hyvor