npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

elevio

v1.3.8

Published

This package contains the Elevio client install packages both in React and native npm module form.

Downloads

28,134

Readme

client-packages

This repository contains all the packages to install Elev.io into your site using an npm package. Currently there are two packages, one that gives you imperative functions to call and the other is a React integration.

You can See documentation of all methods available here: https://api-docs.elevio.help/en/articles/89-how-to-install-elevio-via-npm

Usage

Npm module

Install the package with

npm i elevio

Normal api usage (non-React)

Then you can pull in the Elevio package

import Elevio from 'elevio/lib/client';

or

import { client as Elevio } from 'elevio';

Then make sure before you call any other functions you call the load function and pass in your account id (see the installation page to get our account id). This loads the Elevio javascript and sets up the javascript ready to use.

NOTE You are free to use the on function to setup any event listens at any time you like, so you don't have to wait for the load function to complete before calling that.

Elevio.load('my-account-id').then(() => {
  console.log('Elevio has loaded, ready to use!');
});

Then you are free to call any functions you like, so if you want to open the assistant you can do this

Elevio.open();
Elevio.setKeywords(['keyword1', 'keyword2']);

To subscribe to events you can use the on function, like so

Elevio.on('widget:opened', () => {
  console.log('Elevio has opened!!!');
});

Elevio.on('widget:closed', () => {
  console.log('Elevio has closed!!!');
});

Angular usage

If you are using Angular it is required to use an NgZone so that Elevio doesn't interfere with Angular's change tracking.

import { Component, NgZone } from '@angular/core';

@Component({
  selector: 'app-elevio',
  templateUrl: './elevio.component.html',
  styleUrls: []
})
export class ElevioAndGridComponent {
  article: number;

  constructor(private _ngZone: NgZone) { }

  onClick() {
    this._ngZone.runOutsideAngular(() => {
      (window as any)._elev.openArticle(this.article);
    });
  }
}

For more details see this article ngZone.runOutsideAngular.

React usage

You can view documentation of all available props here https://api-docs.elevio.help/en/articles/90-how-to-integrate-elevio-into-react

Import the package

import Elevio from 'elevio/lib/react';

or for Next.js:

import dynamic from 'next/dynamic';
const Elevio = dynamic(() => import('elevio/lib/react'), { ssr: false });

Then drop the Elevio component into your component hierarchy, making sure you pass the required account id.

<div>
  <Elevio accountId="MY_ACCOUNT_ID" />
</div>

NOTE you can also use a combination of the standard client usage if you want to do something imperative or something that isn't supported by the React wrapper.

Building

To build these packages first close this repository and then install all the decencies.

npm i

Then you can rebuild all the packages by running the npm script build.

npm run build

This build the Elevio package and puts the build files in the lib folder.

Running examples

First install all dependencies by running npm install.

Then fire up the server by running the command npm run example-server. You can then open a browser to http://localhost:4000 to see an index of the example projects.

Running tests

Make sure you have all dependencies installed, then run

  npm run ci

or if you want to run Cypress interactively get the example server running and then

  npx cypress open

Submitting issues / pull requests

If you find an issue or something missing with these packages please feel free to open a ticket. It's helpful if you can describe how the issue is occurring and what your desired outcome is.

Typescript support

These packages have been built using Typescript and the type definitions are included in the package.

License

This elevio package is MIT licensed.