DEV Community

Cover image for I made DEV.to widget for websites/blogs

I made DEV.to widget for websites/blogs

Saurabh Daware 🌻 on October 20, 2019

Hey Everyone! So I made an (Unofficial) DEV.to widget / profile-card which you can use in your websites and blogs (You just have to copy-paste 2 li...
Collapse
 
artis3n profile image
Ari Kalfus • Edited

This is great. Nit: Promote healthy web practices and add sub-resource integrity (SRI) via the integrity attribute on your example.

developer.mozilla.org/en-US/docs/W...

You can grab your hash from unpkg via the meta query parameter:

https://unpkg.com/dev-widget@1.0.1/dist/card.component.mjs?meta

<script src="https://unpkg.com/dev-widget@1.0.1/dist/card.component.mjs" type="module" integrity="sha384-755Jblzb17ugkA3KRCLz4XS8CPb3xEwBdBMk8ZBw51agtKmppILXMJrKvuTRkUhy"></script>
Collapse
 
loujaybee profile image
Lou (πŸš€ Open Up The Cloud ☁️)

Came here to say that too β€” bravo!

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Oh thank you! I've added integity hash to my codepen demo. Not really sure how I can get that hash before publishing so that I can set in readme (Apparently that hash changed from 1.0.1 to 1.0.2)

Thread Thread
 
artis3n profile image
Ari Kalfus • Edited

Yup, the hash will change for each version of the script pushed to the CDN.

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Oh I didn't know about this thank you so much! I'll check it out

Collapse
 
kp profile image
KP

@saurabhdaware this is phenomenal. I know you've open sourced the code but I'd like to build something very similar for my own site. Any pointers on how to get started would be great. Are you using the DEV APIs? Would I need to create those first for my own site before creating a public widget like this?

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Hi KP, yes I've used DEV API. There's a DEV API that returns the list of articles on providing the username. Even in my person website I am doing something similar in the articles section saurabhdaware.in

Thank you for kind words 🌻🌻

Collapse
 
kp profile image
KP • Edited

Thanks @saurabhdaware . Looks like the code you've written is in .mjs file format....which is new to me....I'll give it a closer look and hope you dont mind me forking and using it in the future! Some quick questions for you...

  • What is the advantage of mjs files for modules (versus regular js)? I've never used this file format.
  • How do you host on unpkg, and how do you create a command like this?

    npm install --save dev-widget

  • Any gotchas I need to be aware of / careful of when creating my own widget?

Thanks for the inspiration! 🌻

Thread Thread
 
saurabhdaware profile image
Saurabh Daware 🌻
  • .mjs lets you use import and export in web without having a webpack build environment.

  • You have to publish it as a npm package and all npm packages are synced to unpkg

  • Gotchas:

    • The api does not return user's data directly, It comes under each article value with user's key
    • If user has written 0 articles, you dont get any value so no user data in this case.
    • If you are going to build on top of web components, you'll have to follow the webcomponent best practices (You'll find them on internet) for the widget to work in frameworks

And yes you can go ahead and fork it

Do share the link once you're done :D

Thread Thread
 
kp profile image
KP • Edited

@saurabhdaware thanks! These tips are going to be really helpful.

I'll definitely let you know if I end up using it! First step, I'm trying to simply include your widget locally to see it in action...and then I can start modifying it :D

I'm trying to include this dev widget in my nuxt.js project, in one of my pages. For context, each page in Nuxt is nothing but a vue component.

Here is my code:

<template>
  <div class="container">

    <div>
        <dev-widget data-username="saurabhdaware"></dev-widget>
    </div>

  </div>
</template>

<script>

export default {
  layout: "default",
};
</script>

<script src="https://unpkg.com/dev-widget@1.0.3/dist/card.component.mjs" type="module"></script>

Any idea what I am doing wrong here? I keep getting an error:
Unknown custom element: < dev-widget >

Thread Thread
 
saurabhdaware profile image
Saurabh Daware 🌻

you'll have to follow the npm install and import 'dev-widget' instead of the link</p>

Thread Thread
 
kp profile image
KP

Thank you...there's gotta be a workaround though! It works fine in a raw HTML file...so it should work in vue as well!

Thread Thread
 
saurabhdaware profile image
Saurabh Daware 🌻

You can make it work in framework that way by putting that script file before end of body tag in your index.html.

These frameworks follow a particular standard and having compinents as module is by far the most comfortable way of adding anything. It also makes this process standard since it gets similar to how you would add a usual vue component.

What you write in your vue component is not really staright up appeneded to the final bundle rather they are in some way compiled (in v v v general terms) and they are bundled with vue's code along with it. So it is not really possible to standardize that script include thing (unless you write different widget for different frameworks)

Thread Thread
 
kp profile image
KP

That makes total sense @saurabhdaware . Thanks for the explanation! 🌻

I'll do some more research to see if I can get this working in vue / nuxt component pages!

Thread Thread
 
kp profile image
KP

Here's how to use your widget in Nuxt, for future reference:

@kiyuku1 's answer would work, but here's the complete solution that would work if we want to include a js (or mjs) file in ONE nuxt.js page only, instead of globally:

<template>
  <div class="container">

    <div>
        <dev-widget data-username="saurabhdaware"></dev-widget>
    </div>

  </div>
</template>

<script>

export default {
  layout: "default",

  head: {
    script: [
…
Thread Thread
 
saurabhdaware profile image
Saurabh Daware 🌻

Oh I did not know Nuxt required separate handling. Thank you so much 🌻

Collapse
 
seangwright profile image
Sean G. Wright • Edited

Nice work!

I love that you've made something so many other devs (including myself) appreciate (based on the comments).

The idea isn't that complex - someone else could have done it...

But no one else did - you did!

You took the time to figure everything out, make a quality, modern web component, and shared it with the world.

Congrats and thanks!

πŸ™

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you so much! this means a lot 🌻

Collapse
 
ben profile image
Ben Halpern

This is so beautifully done. I’m super impressed.

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you so much ben🌻 means a lot πŸ¦„πŸ¦„

Collapse
 
loujaybee profile image
Lou (πŸš€ Open Up The Cloud ☁️)

Will this create any significant impact on DEV API consumption?

Collapse
 
z2lai profile image
z2lai • Edited

Wow, this adds so much value to a single-page portfolio by being able to show potential employers all the articles you've written with just TWO LINES OF CODE! The idea is pure genius, the execution looks perfect and I'm sure the code is just as elegant as the execution! I can also imagine this widget boosting the number of people using dev.to to write their articles.

So simple yet so beautiful. Extremely inspiring stuff mate, congratulations!

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you so much for such kind words πŸŒ»πŸŒ»πŸ¦„

Collapse
 
z2lai profile image
z2lai

Wow, I get two sunflowers! I am honoured.

Thread Thread
 
saurabhdaware profile image
Saurabh Daware 🌻

haha your comment was the first thing I saw this morning and is surely gonna help me start my day with positivity, so you deserve a sunflower garden

Here you go: 🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻Thank You!🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻🌻

Collapse
 
rose profile image
Rose

Love the idea, well done 😊

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you so much πŸ¦„

Collapse
 
paulasantamaria profile image
Paula SantamarΓ­a

Looks great, thank you!

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you Paula :D

Collapse
 
fultonbrowne profile image
Fulton Browne

I will use this on my blog, thanks

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

so cool! thank you :D

Collapse
 
deepaksisodiya profile image
Deepak Sisodiya

great

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you :D

Collapse
 
maniflames profile image
Maniflames • Edited

Looks very neat!

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you :)

Collapse
 
nickytonline profile image
Nick Taylor

Cool stuff Saurabh!

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you so much 🌻

Collapse
 
eaich profile image
Eddie

Amazing dude! A+ for Web Components implementation. Loved how you split the css into a separate module. Very impressive.

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank youuu πŸ•ΊπŸŒ»

Collapse
 
prafulla-codes profile image
Prafulla Raichurkar

Cool 🀩

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you Prafulla :D

Collapse
 
zooly profile image
Hugo Torzuoli

So simple, very nice !

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you πŸ¦„

Collapse
 
s_aitchison profile image
Suzanne Aitchison

This is awesome! β™₯️

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you :D

Collapse
 
raghavmisra profile image
Raghav Misra

Amazing! I saw this and was impressed. Then I saw web components, great job. Dev Api use will definitely go up a lot now 😁

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you Raghav :D

Collapse
 
rhymes profile image
rhymes

So cool! Great job!

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you rhymes :)

Collapse
 
anjankant profile image
Anjan Kant

Well done! I'll use it :)

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you 🌻

Collapse
 
caffiendkitten profile image
DaNeil C

great widget!

Collapse
 
saurabhdaware profile image
Saurabh Daware 🌻

Thank you so much :)

Collapse
 
mateusznowak profile image
Mateusz Nowak

Hi, good job! :) How could I use it with React / Gatsby?

Collapse
 
jankoweb profile image
Janko

I'm new here a I tried it with my account (jankoweb) and it does not work. Your example works. Could you help me?