6 Network Options

As a network manager, you can change several network configuration options to suit the needs of your institution or publishing program. Network managers on hosted PressbooksEDU networks can find these settings by clicking ‘Settings’ -> ‘Network Options’ from the Network Admin dashboard.

The network options page features three tabs, each of which features different settings you can configure for your network. These settings and what they control are explained in greater detail below. The tabs are

Network Defaults

The network defaults tab begins by presenting a list of the user names and emails for each of your current network managers and instructions for requesting a change to this list.

Screenshot of the Network Options page showing sample text and three basic tab choices
Screenshot of the Network Options page showing sample ‘Network Managers’ text and three three tab settings options

Book Upload Space

This setting allows you to enforce a per-book storage quota for books on your network. By default this setting is not activated on your PressbooksEDU network. To enforce a size quota for individual books, 1) click the check box in front of the ‘Limit total size of files uploaded to’ prompt, 2) enter the per book quota size you’d like to impose (numerical values in megabytes or MB), and 3) click ‘Save Changes’.

If you choose to impose a per-book storage limit on your network, users who have exceeded the limit will be unable to upload new media to their books, and will see an “Upload Limit Exceeded: Sorry, you have used your space allocation of ### MB. Please delete some files to upload more files.” message when attempting to add new files. As a PressbooksEDU network manager, you can also monitor per book space usage with the book list or network analytics stats pages.

Max upload file size

By default, all PressbooksEDU networks impose a maximum file size upload limit of 25000 kB (25 MB). If you would like to reduce (but not increase) this limit on your network, you may. To do so: 1) enter your desired maximum file upload size in this field, expressed as kB (1000 kB = 1 MB) and 2) click ‘Save Changes’.

NOTE: You cannot increase this limit above 25000 kB (25 MB) on PressbooksEDU hosted networks. If you try to set a value above the permitted limit, you will receive a warning prompt and your changes will not be saved.

Default Book Theme

While book administrators can select whatever theme they’d like to use for their books, at the time of initial creation, each newly created or cloned book is created with a network default book theme. All PressbooksEDU networks begin by using McLuhan as their default theme. As a network manager, you can choose to designate another book theme as the default book theme for your network. To change the default book theme used for newly created or cloned books on your network, 1) select your desired option from this drop-down menu and 2) click ‘Save Changes’.

NOTE: Changing the network default book theme will not affect any existing books on your network. Furthermore, no matter what theme you select to you as your network default, book administrators will still retain the ability to change from the default to any available theme on a book by book basis.

Default Language

Each book is created with a default language at the type of its creation. This value can later be changed by book administrators. To change the default language for new books created on your network, 1) select your preferred option from the drop down menu and 2) click ‘Save Changes’. If you would like to select a language option that you do not see listed in the dropdown menu, please contact us through premium support.

Default PDF Page Size

At the time of creation, books also have a default PDF page size. This refers to the size of the page used when generating PDF exports, and can be changed by book administrators in their theme options. By default, the value is set to ‘Digest (5.5″ x 8.5″)’ for all PressbooksEDU networks.

If you would prefer for books to have a different default PDF page size value, you can set your preferred value using this setting. To do so, 1) select your preferred page size, either choosing from the list of common presets, or by selecting custom and entering your desired values using CSS-compatible units, (like in or cm), and 2) click ‘Save Changes’.

Iframe Whitelist

An iframe is an HTML element which allows users to embed an HTML document (i.e. a webpage) from one source inside of another HTML document (i.e. your webbook). Because the use of iframes involve embedding content from external sites into Pressbooks, our default security practices are to prevent users with permissions lower than Network Manager from embedding iframes from non-trusted sources into their books. However, Network Managers can whitelist trusted domains or paths to permit users to embed iframes from that source using this setting.

To add a domain or path to your network iframe whitelist, paste the desired domain or path into the Iframe Whitelist field on its own line. Guidelines for the expected input format are included below the input field.

NOTE: A whitelisted domain or path must match the iframe src URL exactly in order for the iframe to properly embed and display.

Once you have saved changes to your iframe whitelist, any iframe whose src attribute matches a domain or path on your whitelist will pass through our security filter and can be added to a book by any user on the network. Please note that content cloned from other networks may include iframes from sources which have not been whitelisted on your network. If this is the case, these iframes will not display in the cloned book.

Book & User Registration

Allow registered users to create and clone new books

As a network manager, you can decide whether or not users on your network have the permission to create or clone new books on the network. This box is checked by default on PressbooksEDU networks, which means that registered users can create new books and clone books onto your network. If this box is unchecked, only network managers will be able to create new books and clone books on your network. You would then be able to add or invite registered users to books that you have already created or provisioned for them.

Allow user self-registration

As a network manager, you can decide whether or not visitors to your network can self-register for user accounts on your network. This box is unselected by default on PressbooksEDU networks, which means that new user accounts can only be created by invitation.

NOTE: If you decide to allow user self-registration on your network, you should also use the ‘limited email registrations’ option so that self-registration is limited only to users with email addresses issued by your institution, per the terms of your institution’s agreement with Pressbooks.

If you’d like to enable user self-registration for your network, you can do so by 1) checking this box, and 2) clicking ‘Save Changes’. If checked, non-logged in visitors will see a ‘Sign Up’ link next to ‘Sign In’ when visiting the network home page (shown below).

Screenshot of Pressbooks home page with 'sign in' link visible next to 'sign up'
Screenshot of a sample Pressbooks network home page with a ‘sign in’ link (permitting user self-registration) visible next to ‘sign up’ in the top right.

If visitors to your network click the ‘Sign Up’ link, they’ll be taken to a user account registration page (shown below) which asks them to provide a user name, email address, and password, and to accept your network terms of service (if you have enabled this feature). They are also asked whether they would like to create a new book at the time of registration or wait until later to do so.

Example Pressbooks self-registration sign up page. Includes prompts for user name, email address, password, terms of service check box and whether they'd like to also create a book at this time.
Example Pressbooks self-registration sign up page. This sample page includes prompts for user name, email address, password, terms of service check box (an optional feature) and whether they’d like to also create a book at this time.

Allow book administrators to invite new users as collaborators on their book

As a network manager, you can also decide whether or not book administrators have the power to invite collaborators to join them in their books. This box is unchecked by default, which means that book admins will not see the ‘Users’ option in their book dashboard, and will be unable to invite new or existing users to join them in their books. In this scenario, network managers will be the only users who can add new users to existing books.

If you would like to enable book administrators to invite new or existing users to join them as collaborators in their books, you can do so by 1) checking this box and 2) clicking ‘Save Changes’. When this option is selected, book admins will be able to invite existing and existing users to their books and administer those users’ roles within their book (i.e. make them admins, editors, authors, contributors, subscribers) using the Users menu from their book dashboard. Any collaborators that book admins add to their individual books will also become regular users on your network once their accounts are confirmed, giving them the same powers as any other regular user (like the ability to create or clone new books, if granted).

Limited Email Registrations

As a network manager, you can set limits on which users are permitted to register accounts on your network by specifying one or more permitted email domains for user accounts. For example, you may be running a PressbooksEDU network for Utopia State University, where all users are issued utopiastate.edu or utopu.edu email account. If you would like to restrict new user registrations to only people who have an email address from one of these domains, you could do so by 1) entering each of the permitted domains on its own line and 2) clicking ‘Save Changes’. Using the example provide above, you’d put utopiastate.edu on one line and utopu.edu on a second line, as shown in the screenshot below:

Screenshot showing limited email domain registrations for utopiastate.edu and utopu.edu in Pressbooks
Screenshot showing limited email domain registrations for `utopiastate.edu` and `utopu.edu`
Note: This setting is most commonly used with networks that permit self-registration, though it can also be used in conjunction with other network settings configurations. Where set, these email limits apply to users added by any method, including users invited by network managers or book administrators. This means that if your network were to use limited email registrations for utopiastate.edu addresses only, you could not invite a user with an abraxa.edu email address to join your network, unless you removed the limited email registrations or added this additional domain to your list of limited email registration domains.

Banned Email Domains

As a network manager, you can also ban users with certain email domains from registering for your network. This feature functions like the limited email registration option above, except that it prevents any users with emails from the specified domains from being registered on your network. This features is very rarely used by PressbooksEDU network managers, but may be helpful if you permit book admins to add collaborators to their books, but don’t want them to invite collaborators with emails issued by a specific provider or organization.

To ban email domains from being able to be registered on your site, 1) enter each of the domains you wish to ban on its own line in the banned email domains field, and 2) click ‘Save Changes’.

Email Notifications

If desired, you can send email notifications to one or more email addresses each time a new book or user is registered on your PressbooksEDU network. To send these notifications, 1) check the ‘Send the network admin an email notification every time someone registers a site or user account’ box, 2) enter the email addresses you’d like to send these notifications to in the input field below, with one email per line (as seen below), and 3) click ‘Save Changes’.

Sample email notification setting in Pressbooks with two example email addresses provided.
Sample email notifications setting in Pressbooks shown with two example email addresses provided, one on each line.

Require users to opt-in to terms of service at registration

Note: This setting (and those that follow it) are only relevant if you’ve selected the ‘Allow user self-registration’ option to allow users to self-register for accounts on your network.

When selected, this setting adds a check box requiring a user to accept your terms of service as part of their self-registration process. You can specify which page on your root network will serve as your terms of service using the next setting.

Terms of Service page

The opt-in setting requires described above requires users to a opt-in to your terms of service when completing the user self-registration process. This setting lets you select which page on your root network will serve as your network’s terms of service. You will only be able to select a terms of service page if the previous option ‘Require users to opt-in to terms of service at registration’ is selected.

You can create a Terms of Service page at any time by following the instructions provided in the Creating a Custom Terms of Service Page chapter in this guide. Once you’ve created and published the page you’d like to serve as your Terms of Service at your network root, that page will appear as one of the in the dropdown menu choices for this setting.

To set a terms of service page, 1) create & publish a terms of service page, 2) select the title of the desired page from the dropdown menu in this setting (as shown below), and 3) click Save Changes.

Pressbooks network settings with terms of service page selected
Pressbooks network settings page with the opt-in option selected and a ‘terms of service’ page selected

Welcome Email and Welcome User Email

These field contains the text of welcome emails sent to newly registered users under very specific conditions. The ‘Welcome Email’ message is only sent when all of the following are true: 1) your network permits self-registration, 2) a new user successfully self-registers and 3) as part of their registration, the new user elects to create a book at the time of registration and 4) that user successfully activates their newly created book by responding to a confirmation email.

The ‘Welcome User Email’ message is only sent when all of the following are true: 1) your network permits self-registration, 2) a new user successfully self-registers, 3) as part of their registration, the new user chooses not to create a book at the time of registration, and 4) that that user successfully activates their account by responding to a confirmation email.

You may notice that some parts of these default messages are written in ALL CAPS. These strings are special variables that will be replaced in the actual email with contextually relevant text (i.e. USERNAME will be replaced by the actual username value of the recipient).

You can personalize either or both of these message, if desired. To do so, edit, add, or remove text from the message and click the ‘Save Changes’ button at the bottom of the page.

Third-Party Tools

Google Analytics ID

As a network manager, you’re able to send visitor traffic information to a Google Analytics dashboard if you so desire. To begin, 1) use the Google Analytics dashboard and create a new web ‘property’ for your Pressbooks network (i.e. the URL of your network itself). Doing so will give you a Google Analytics ID for that property. Once this has been generated, 2) paste this value in the Google Analytics ID field and 3) Click ‘Save Changes’.

Once your Google Analytics ID has been saved here, your Pressbooks network will begin sending information about web traffic and book download events to your Google Analytics dashboard. For more details about using Google Analytics with your Pressbooks network, see our guide resource on Installing and Configuring Google Analytics for Pressbooks.

License

Icon for the Creative Commons Attribution 4.0 International License

The Pressbooks Network Manager's Guide by Pressbooks is licensed under a Creative Commons Attribution 4.0 International License, except where otherwise noted.

Share This Book