Skip to content

Latest commit

 

History

History
150 lines (107 loc) · 3.79 KB

WIDGET.md

File metadata and controls

150 lines (107 loc) · 3.79 KB

Widgets

Why

These widgets will help you advertise your support for Gitcoin bounties.

We support both image widgets (see below) and dynamically resizing javascript widgets (see directly below)

Dynamic Javascript Widget

Preview

The JS image is responsive. Here are some screenshots of it:

Example

Click here to see an example JSFiddle widget

Step 1: Include the JavaScript SDK on your page once, ideally right after the opening body tag.

<div id="gc-root"></div>
<script>(function(d, s, id) {
  var js, gjs = d.getElementsByTagName(s)[0];
  if (d.getElementById(id)) return;
  js = d.createElement(s); js.id = id;
  js.src = "https://unpkg.com/gitcoin-sdk";
  gjs.parentNode.insertBefore(js, gjs);
}(document, 'script', 'gitcoin-jssdk'));</script>

Step 2: Place this code wherever you want the plugin to appear on your page.

<div class="gitcoin-widget"
  data-limit="2"
  data-order-by="-expires_date"
  data-organization="MetaMask"
  data-repository="metamask-extension"
></div>

Autoloading

Importing the SDK into your application will attempt to autoload the widget by searching for '.gitcoin-widget' selectors

import 'gitcoin-sdk';

or

require('gitcoin-sdk');

Programmatically

You can also use the Widget programmatically.

import { Widget } from 'gitcoin-sdk';

or

const { Widget } = require('gitcoin-sdk');

Widget can be instantiated by passing a selector option, or an element reference.

new Widget({
  limit: 10,
  orderBy: '-expires_date',
  organization: 'MetaMask',
  repository: 'metamask-extension',
  selector: '.gitcoin-widget',
});

Static Image Widget

Example

<a href="https://gitcoin.co/explorer?q=gitcoinco">
    <img src="https://gitcoin.co/funding/embed?repo=https://github.com/gitcoinco/web">
</a>

Results

Repos that have this widget can expect to see 35% more interest in their repo's bounties

Code

Place the following code into your repo readme:

<a href="https://gitcoin.co/explorer?q=YOUR_REPO_NAME">
    <img src="https://gitcoin.co/funding/embed?repo=https://github.com/YOUR_ORG_NAME/YOUR_REPO_NAME">
</a>

Make sure to replace the YOUR_ORG_NAME and YOUR_REPO_NAME text with your org and repo names!

Example:

<a href="https://gitcoin.co/explorer?q=gitcoinco">
    <img src="https://gitcoin.co/funding/embed?repo=https://github.com/gitcoinco/web">
</a>

Also, if you add &badge=1 to the image URL, a la

<a href="https://gitcoin.co/explorer?q=gitcoinco">
    <img src="https://gitcoin.co/funding/embed?repo=https://github.com/gitcoinco/web&badge=1">
</a>

you will see a badge version of this widget.

More Examples

Badge

Metamask Widget

Ethereum web3py Widget

Market Protocol Widget