# vuepress-plugin-disqus

> Register a global Disqus component to add to your layouts

Latest version **0.2.0** (published 2020-01-13) · MIT license · 0 weekly downloads

## Install

```sh
npm install vuepress-plugin-disqus
pnpm add vuepress-plugin-disqus
yarn add vuepress-plugin-disqus
bun add vuepress-plugin-disqus
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.0 |
| Published | 2020-01-13 |
| First published | 2019-02-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 29 |
| Author | Loris Leiva |
| Maintainers | lorisleiva |
| Keywords | vuepress, plugin, disqus |

## Links

- npm: https://www.npmjs.com/package/vuepress-plugin-disqus
- Repository: https://github.com/lorisleiva/vuepress-plugin-disqus
- Homepage: https://github.com/lorisleiva/vuepress-plugin-disqus#readme
- Issues: https://github.com/lorisleiva/vuepress-plugin-disqus/issues
- npm.io page: https://npm.io/package/vuepress-plugin-disqus

## Dependencies (1)

- [vue-disqus](https://npm.io/package/vue-disqus.md) ^3.0.5

## Recent versions

- 0.2.0 (latest) — 2020-01-13
- 0.1.1 — 2019-02-04
- 0.1.0 — 2019-02-04

## README

# Vuepress Plugin Disqus
🔌 Register a global `<Disqus />` component to add to your layouts.

This plugins is a vuepress wrapper of [vue-disqus](https://github.com/ktquez/vue-disqus).

## Installation

```bash
npm i vuepress-plugin-disqus -D
```

## Register the plugin

```js
plugins: {
    'disqus': { /* options */ }
},
```

Please check out [Config](#config) for options.

Note that Vuepress allows multiple syntaxes to register plugins. See [Vuepress documentation on how to use a plugin](https://vuepress.vuejs.org/plugin/using-a-plugin.html) for more information.

## Use the Disqus component

This plugin present a out-of-box SSR-friendly component  - `<Disqus/>`. Just put it wherever you like, and Disqus will be embedded in the right place. For example:

```html
<template>
  <div>
    <Content />
    <!-- ...... -->
    <Disqus />
  </div>
</template>
```
Or you can simply put it in your `.md` file.
```markdown
## Hello VuePress

This is a demo.

<Disqus/>
```

You can use all the props and events defined by [vue-disqus](https://github.com/ktquez/vue-disqus).

Prop            | Data Type  | required  | Description
--------------- | ---------- | --------- | -----------
`shortname`     | String     | true      | Your disqus shortname.
`url`           | String     | false     | Your URL where Disqus is present
`title`         | String     | false     | Title that identifies the current page.
`identifier`    | String     | false     | The page's unique identifier
`sso_config`    | Object     | false     | Single sign-on (SSO)
`api_key`       | String     | false     | Your API key disqus
`remote_auth_s3`| String     | false     | implementation with Laravel/PHP
`language`      | String     | false     | Language overrides

## Config 

See the table above. All the props are also configuration options for this plugin. They'll be passed to every `Disqus` component. You're still able to override it by passing down props. Note that if you don't set language, it'll use VuePress's $lang as default language.

There's still one option available - `name` which specifies the name of the disqus component. Defaults to: `Disqus`.

---
_Source: https://npm.io/package/vuepress-plugin-disqus · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._