Notorious Public Menace

    sharethis-angular
    TypeScript icon, indicating that this package has built-in type declarations

    2.1.3 • Public • Published

    sharethis-angular

    ShareThis Share Buttons for Angular apps/sites. Empower your online audience to share and amplify your content on social networks such as Facebook, WhatsApp, Linkedin, Twitter and many more. Includes four types of share buttons - Inline Share Buttons, Sticky Share Buttons, Inline Follow Buttons and Inline Reaction Buttons.

    Demo

    View the live demo here

    Requirement

    Angular 14.1.0 or higher

    Installation

    npm

    npm install sharethis-angular

    Add SharethisAngularModule module

    In module file, for example: /<project-name>/src/app/app.module.ts

    import { SharethisAngularModule } from 'sharethis-angular';
    @NgModule({
      declarations: [
        AppComponent
      ],
      imports: [
        BrowserModule,
        AppRoutingModule,
        SharethisAngularModule
      ],
      providers: [],
      bootstrap: [AppComponent]
    })
    export class AppModule { }

    Customize component configuration

    In component file, for example: <project-name>/src/app/app.component.ts

    import { Component } from '@angular/core';
    import { InlineShareButtonsConfig } from 'sharethis-angular';
    
    const inlineShareButtonsConfig:InlineShareButtonsConfig = {
      alignment: 'center', // alignment of buttons (left, center, right)
      color: 'social', // set the color of buttons (social, white)
      enabled: true, // show/hide buttons (true, false)
      font_size: 16, // font size for the buttons
      labels: 'cta', // button labels (cta, counts, null)
      language: 'en', // which language to use (see LANGUAGES)
      networks: [
      // which networks to include (see SHARING NETWORKS)
      'whatsapp',
      'linkedin',
      'messenger',
      'facebook',
      'twitter',
      ],
      padding: 12, // padding within buttons (INTEGER)
      radius: 4, // the corner radius on each button (INTEGER)
      show_total: true,
      size: 40, // the size of each button (INTEGER)
    };
    
    @Component({
      selector: 'app-root',
      templateUrl: './app.component.html',
      styleUrls: ['./app.component.css']
    })
    export class AppComponent {
      title = 'sharethis-angular-test';
      inlineShareButtonsConfig = inlineShareButtonsConfig;
    }

    Add component to HTML

    In HTML file, for exampe: <project-name>/src/app/app.component.html

    <st-inline-share-buttons [config]="inlineShareButtonsConfig"></st-inline-share-buttons>

    You can also use 3 other types of share buttons:

    <st-inline-follow-buttons [config]="inlineFollowButtonsConfig"></st-inline-follow-buttons>
    <st-inline-reaction-buttons [config]="inlineReactionButtonsConfig"></st-inline-reaction-buttons>
    <st-sticky-share-buttons [config]="stickyShareButtonsConfig"></st-sticky-share-buttons>

    Share Button Configurations

    Inline Share Buttons

    import { InlineShareButtonsConfig } from 'sharethis-angular';
    
    const inlineShareButtonsConfig:InlineShareButtonsConfig = {
      alignment: 'center', // alignment of buttons (left, center, right)
      color: 'social', // set the color of buttons (social, white)
      enabled: true, // show/hide buttons (true, false)
      font_size: 16, // font size for the buttons
      labels: 'cta', // button labels (cta, counts, null)
      language: 'en', // which language to use (see LANGUAGES)
      networks: [
      // which networks to include (see SHARING NETWORKS)
      'whatsapp',
      'linkedin',
      'messenger',
      'facebook',
      'twitter',
      ],
      padding: 12, // padding within buttons (INTEGER)
      radius: 4, // the corner radius on each button (INTEGER)
      show_total: true,
      size: 40, // the size of each button (INTEGER)
      // OPTIONAL PARAMETERS
      url: 'https://www.sharethis.com', // (defaults to current url)
      image: 'https://bit.ly/2CMhCMC', // (defaults to og:image or twitter:image)
      description: 'custom text', // (defaults to og:description or twitter:description)
      title: 'custom title', // (defaults to og:title or twitter:title)
      message: 'custom email text', // (only for email sharing)
      subject: 'custom email subject', // (only for email sharing)
      username: 'custom twitter handle', // (only for twitter sharing)
    };

    Sticky Share Buttons

    import { StickyShareButtonsConfig } from 'sharethis-angular';
    
    const stickyShareButtonsConfig: StickyShareButtonsConfig={
      alignment: 'left', // alignment of buttons (left, right)
      color: 'social', // set the color of buttons (social, white)
      enabled: true, // show/hide buttons (true, false)
      font_size: 16, // font size for the buttons
      hide_desktop: false, // hide buttons on desktop (true, false)
      labels: 'counts', // button labels (cta, counts, null)
      language: 'en', // which language to use (see LANGUAGES)
      min_count: 0, // hide react counts less than min_count (INTEGER)
      networks: [ // which networks to include (see SHARING NETWORKS)
      'linkedin',
      'facebook',
      'twitter',
      'pinterest',
      'email'
      ],
      padding: 12, // padding within buttons (INTEGER)
      radius: 4, // the corner radius on each button (INTEGER)
      show_total: true, // show/hide the total share count (true, false)
      show_mobile: true, // show/hide the buttons on mobile (true, false)
      show_toggle: true, // show/hide the toggle buttons (true, false)
      size: 48, // the size of each button (INTEGER)
      top: 160, // offset in pixels from the top of the page
      // OPTIONAL PARAMETERS
      url: 'https://www.sharethis.com', // (defaults to current url)
      image: 'https://bit.ly/2CMhCMC', // (defaults to og:image or twitter:image)
      description: 'custom text', // (defaults to og:description or twitter:description)
      title: 'custom title', // (defaults to og:title or twitter:title)
      message: 'custom email text', // (only for email sharing)
      subject: 'custom email subject', // (only for email sharing)
      username: 'custom twitter handle' // (only for twitter sharing)
    };

    Inline Follow Buttons

    import { InlineFollowButtonsConfig } from 'sharethis-angular';
    
    const inlineFollowButtonsConfig: InlineFollowButtonsConfig = {
      action: 'Follow us:', // call to action (STRING)
      action_enabled: true, // show/hide call to action (true, false)
      action_pos: 'bottom', // position of call to action (left, top, right)
      alignment: 'center', // alignment of buttons (left, center, right)
      color: 'white', // set the color of buttons (social, white)
      enabled: true, // show/hide buttons (true, false)
      networks: [ // which networks to include (see FOLLOW NETWORKS)
      'twitter',
      'facebook',
      'instagram',
      'youtube'
      ],
      padding: 8, // padding within buttons (INTEGER)
      profiles: { // social profile links for buttons
      twitter: 'sharethis',
      facebook: 'sharethis',
      instagram: 'sharethis',
      youtube: '/channel/UCbM93niCmdc2RD9RZbLMP6A?view_as=subscriber'
      },
      radius: 9, // the corner radius on each button (INTEGER)
      size: 32, // the size of each button (INTEGER)
      spacing: 8 // the spacing between buttons (INTEGER)
    };

    Inline Reaction Buttons

    import { InlineReactionButtonsConfig } from 'sharethis-angular';
    
    const inlineReactionButtonsConfig: InlineReactionButtonsConfig = {
      alignment: 'center', // alignment of buttons (left, center, right)
      enabled: true, // show/hide buttons (true, false)
      language: 'en', // which language to use (see LANGUAGES)
      min_count: 0, // hide react counts less than min_count (INTEGER)
      padding: 12, // padding within buttons (INTEGER)
      reactions: [ // which reactions to include (see REACTIONS)
      'slight_smile',
      'heart_eyes',
      'laughing',
      'astonished',
      'sob',
      'rage'
      ],
      size: 48, // the size of each button (INTEGER)
    };

    License

    MIT License

    Copyright (c) 2022 ShareThis Inc

    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Footer

    Install

    npm i sharethis-angular

    DownloadsWeekly Downloads

    135

    Version

    2.1.3

    License

    none

    Unpacked Size

    109 kB

    Total Files

    24

    Last publish

    Collaborators

    • st-operations