Text of docs.openlibrary.org › projects › developing-the-reading-log.html as Styx crawled it on Nov 18, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Developing the Reading Log | Open Library Docs

Skip to content Developing the Reading Log ​ This is a tutorial on contributing to the "My Books" experience and developing the Reading Log. For information on using the My Books Dropper, go here . The Patron's Experience ​ When a patron clicks the My Books main navigation button, they are taken to /account/books and shown the My Books overview, which provides a summary of their loans, lists, reading log, and more: Templates ​ The HTML template that renders the My Books experience is books.html .

This base template renders various My Books pages and includes a left sidebar menu: The books.html template also defines rules for determining which primary content and sub-templates are rendered to the right of the menu: The main books.html base template is used to render the patron's... My Books Overview page (shown above) Loans page Reading Log pages -- example Lists overview page Individual List pages Loan History page (in development but will look similar to the Reading Log pages) Routing ​ As explained in the Patron's Experience section, when a patron clicks the My Books button, they are taken to /account/books , which redirects to /people/{openlibrary_username}/books .

The router that handles these redirects is defined in https://github.com/internetarchive/openlibrary/blob/35d6b72c7851f260d673fbcd9ce3f95b0e9c3169/openlibrary/plugins/upstream/account.py#L792-L811 . These redirects route to another set of routes defined in the mybooks.py plugin: https://github.com/internetarchive/openlibrary/blob/master/openlibrary/plugins/upstream/mybooks.py#L23-L44 . These routers look for URL patterns of the form /people/{openlibrary_username}/{path} and use the MyBooksTemplate (defined at https://github.com/internetarchive/openlibrary/blob/35d6b72c7851f260d673fbcd9ce3f95b0e9c3169/openlibrary/plugins/upstream/mybooks.py#L184-L368 ) to render the appropriate My Books view (overview, loans, loan history, reading log, lists, an individual list, etc.).

Depending on the {path} specified in the URL, different models may be used to prepare and fetch data, and different sub-templates will be rendered within the books.html base template. Within MyBooksTemplate , a variable named key is used to determine what data to fetch and which sub-templates to render based on the {path} . Example Data Flow ​ Patron types in the url /account/books after logging in, which is matched by the route in plugins/account.py Patron is redirected to /people/{their_openlibrary_username}/books which is matched by the my_books_home or my_books_view routes in plugins/mybook.py on https://github.com/internetarchive/openlibrary/blob/master/openlibrary/plugins/upstream/mybooks.py#L23 The router calls the MyBooksTemplate controller with a key of mybooks (instructing it to fetch the corresponding data for, and to render, the mybooks view): https://github.com/internetarchive/openlibrary/blob/master/openlibrary/plugins/upstream/mybooks.py#L184 In the preamble / initialization of the MyBooksTemplate controller, shared data will be fetched that is required by every view to generate the left sidebar menu (such as the logged in patron, the names of their lists, reading log counts): https://github.com/internetarchive/openlibrary/blob/master/openlibrary/plugins/upstream/mybooks.py#L202-L237 Next, different if statements and control structures are hit to determine which data we should load and send to templates/books.html based on the key derived from the url pattern (e.g. mybooks , lists , loan_history , etc).

In this example, we determine based on the url we're on and the key value specified, that the LoggedBooksData model should be used to fetch the book data we need to render our view: https://github.com/internetarchive/openlibrary/blob/35d6b72c7851f260d673fbcd9ce3f95b0e9c3169/openlibrary/plugins/upstream/mybooks.py#L254-L270 Eventually, when all the appropriate data is collected, it will be passed into the books.html base template: https://github.com/internetarchive/openlibrary/blob/35d6b72c7851f260d673fbcd9ce3f95b0e9c3169/openlibrary/plugins/upstream/mybooks.py#L288-L303 In books.html , logic is defined that dynamically determines what the title of the web page should be ( https://github.com/internetarchive/openlibrary/blob/35d6b72c7851f260d673fbcd9ce3f95b0e9c3169/openlibrary/templates/account/books.html#L27-L54 ), renders the left sidebar ( https://github.com/internetarchive/openlibrary/blob/master/openlibrary/templates/account/books.html#L74 ) and then renders the correct child template for this view: https://github.com/internetarchive/openlibrary/blob/master/openlibrary/templates/account/books.html#L154-L173 Extending the My Books system ​ A new router defining your desired url pattern needs to be defined in plugins/mybooks.html , such as is done by my_books_view .

This router should make a call to MyBooksTemplate().render() MyBooksTemplate should be updated so there is an additional check within the if / elif control flow for the new key or page you wish to add. This section should fetch the books or data which will be required by the view. You'll want to update templates/book.html (the base template for all of My Books views) so that it defines what the title should be and what templates should be rendered when your url pattern / key is encountered.

You may then have to create a new template within templates/account/ that renders the data in a suitable way. In many cases, we'll want to refer to the account/reading_log.html template as the basis for our design: https://github.com/internetarchive/openlibrary/blob/master/openlibrary/templates/account/reading_log.html For a complete, minimal example of adding a new page or view to the My Books system, please refer to PR #8375 as well as this comment which describes how data specific to a new loan_history page may be prepared that is suitable to be passed through the account/books.html base template.

Extending the Reading Log: An (outdated) example ​ Note: This section is outdated because much of the routing and controller logic has been moved from plugins/upstream/account.py to plugins/upstream/mybooks.py within MyBooksTemplate . This section remains useful for understanding how to extend the Reading Log functionality, such as adding the ability to search books on the Currently Reading, Want to Read, and Already Read shelves.

In #5080 , you can read through a slightly unrealistic example of adding Search filtering capabilities to the Reading Log: This proposal will not work as implemented because book titles, authors, and other searchable data are not stored in the ReadingLog database table—only the Open Library identifiers. This may be achievable with Solr in the future. But assuming we did have the desired info in our database (and as a thought exercise): First, we'd need to update the Reading Log html template ( https://github.com/internetarchive/openlibrary/blob/master/openlibrary/templates/account/books.html ) to include a search box (design task).

For a first version, we'd probably use an html form which submits a GET search query , similar to what we have on the author's page: https://openlibrary.org/authors/OL7283091A . In the future, we might want to use javascript (similar to how the real-time Search box works at the top of the website): Next, we'd need to update the public_my_books controller method in https://github.com/internetarchive/openlibrary/blob/master/openlibrary/plugins/upstream/account.py#L733-L760 to accept a GET parameter.

Already, the function expects a page variable to be sent as a GET parameters ( https://github.com/internetarchive/openlibrary/blob/master/openlibrary/plugins/upstream/account.py#L738 ) so accomplishing this should be as straightforward as adding another parameters like, i = web.input(page=1, search=None) . When/where we fetch the patron's books here: https://github.com/internetarchive/openlibrary/blob/master/openlibrary/plugins/upstream/account.py#L754 , we need to alter the logic to check whether a

The rest of this page is on the live site.