PHPackages                             loukel/goodreads - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. loukel/goodreads

ActiveLibrary

loukel/goodreads
================

Goodreads RSS reader: PHP class that has a function to return an array of each books' attributes on a specified shelf. Therefore, you can have a dynamic bookshelf that updates when you update Goodreads. The widgets Goodreads provides are quite restrictive and are static.

06PHP

Since Feb 23Pushed 5y ago1 watchersCompare

[ Source](https://github.com/loukel/Goodreads)[ Packagist](https://packagist.org/packages/loukel/goodreads)[ RSS](/packages/loukel-goodreads/feed)WikiDiscussions main Synced 4w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Goodreads
=========

[](#goodreads)

Goodreads RSS reader, PHP class that has a function to return an array of each books' attributes on a specified shelf. The books can also be sorted.

Purpose
-------

[](#purpose)

Goodreads does have widgets that you can use but the design is limited and they are not dynamic so they will have to be manually updated. Goodreads also have RSS which I have used but the RSS files were very ugly and awkward to use, and so I created this Goodreads class to make it easier to dynamically add books to your web applications and therefore you can use Goodreads and the site is updated automatically as you add more books.

Functionality
-------------

[](#functionality)

You can use any public shelf on your goodreads account by declaring the first parameter and you can also sort the shelf by declaring the second parameter in the shelf function.

Installation
------------

[](#installation)

composer require loukel/goodreads
composer install

OR

git clone

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity30

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/573eef552c3a7c423918970cd49e6e18b5d3757e5e257c33629582c299fbfe0e?d=identicon)[loukel](/maintainers/loukel)

---

Top Contributors

[![loukel](https://avatars.githubusercontent.com/u/65136145?v=4)](https://github.com/loukel "loukel (16 commits)")

---

Tags

booksbookshelfdynamicgoodreadsgoodreads-apigoodreads-rss-readerpersonalpersonal-websitephpphp7rssshelf

### Embed Badge

![Health badge](/badges/loukel-goodreads/health.svg)

```
[![Health](https://phpackages.com/badges/loukel-goodreads/health.svg)](https://phpackages.com/packages/loukel-goodreads)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)