{"id":62,"date":"2023-03-08T07:16:21","date_gmt":"2023-03-08T07:16:21","guid":{"rendered":"https:\/\/integrations.pressbooks.network\/testampersands\/?post_type=chapter&#038;p=62"},"modified":"2023-04-03T17:36:03","modified_gmt":"2023-04-03T17:36:03","slug":"adjust-network-settings-2","status":"web-only","type":"chapter","link":"https:\/\/integrations.pressbooks.network\/testampersands\/chapter\/adjust-network-settings-2\/","title":{"raw":"Adjust Network Settings","rendered":"Adjust Network Settings"},"content":{"raw":"As a network manager of a Pressbooks network, you can change several network configuration options to suit the needs of your institution or publishing program. To access your Network Options, click <strong>Settings<\/strong> from your Administer Network dashboard.\r\n<h1>View Current Network Managers<\/h1>\r\nThis section displays a list of user names and email addresses for your current network managers and instructions for requesting a change to this list.\r\n<h1>View LTI 1.3 connection usage<\/h1>\r\nThis section displays the number of students who have used the grade passback feature included in our optional <a href=\"https:\/\/pressbooks.pub\/networkmanagerguide\/part\/use-pressbooks-results-for-lms\/\">Results for LMS product add-on<\/a> and provides instructions for purchasing more student connections for your network, if desired.\r\n<img class=\"size-full wp-image-63 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2019\/08\/Screenshot-from-2022-03-18-15-39-06.png\" alt=\"\" width=\"852\" height=\"141\" \/>\r\n<h1>Enforce Book Upload Space Quota<\/h1>\r\nThis setting allows you to enforce a per-book storage quota for books on your network. By default this setting is not activated on your Pressbooks network. To enforce a size quota for individual books:\r\n<ol>\r\n \t<li><strong>Click the check box<\/strong> in front of the 'Limit total size of files uploaded to' prompt<\/li>\r\n \t<li><strong>Enter the per book quota size<\/strong> you'd like to impose (numerical values in megabytes or MB)<\/li>\r\n \t<li>Click <strong style=\"orphans: 1; text-align: initial; font-size: 1em;\">Save Changes<\/strong><span style=\"orphans: 1; text-align: initial; font-size: 1em;\">.<\/span><\/li>\r\n<\/ol>\r\n<div class=\"textbox shaded\">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 the following message: \"Upload Limit Exceeded: Sorry, you have used your space allocation of ### MB. Please delete some files to upload more files.\" when attempting to add new files. As a Pressbooks network manager, you can also monitor per book space usage with the <a href=\"http:\/\/networkmanagerguide.pressbooks.com\/chapter\/book-list\/\">book list<\/a> or network analytics <a href=\"http:\/\/networkmanagerguide.pressbooks.com\/chapter\/network-analytics\/\">stats<\/a> pages.<\/div>\r\n<h1>Set Max upload file size<\/h1>\r\nBy default, all Pressbooks networks impose a maximum file size upload limit of 25000 kB (25 MB). However, you can <em>reduce<\/em> this limit on your network if you wish. To do so enter your desired maximum file upload size in this field, expressed as kB (1000 kB = 1 MB) and click <strong>Save Changes<\/strong>.\r\n<div class=\"textbox shaded\"><strong>NOTE:<\/strong> You cannot increase this limit above 25000 kB (25 MB) on Pressbooks 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.<\/div>\r\n<h1>Set Default Book Theme<\/h1>\r\nWhile book administrators can select whatever theme they'd like to use for their books, each new book created on your network will have have your network's default book theme applied when it is created.\r\n\r\nPressbooks networks generally use Malala 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 your network's default book theme, select your desired theme from this drop-down menu and click <strong>Save Changes<\/strong>.\r\n<div class=\"textbox shaded\"><strong>NOTE:\u00a0<\/strong>Changing the network default book theme will not affect any <em>existing<\/em> books on your network. No matter which theme you select as your network default, book administrators can still apply any available theme to their book at any time.<\/div>\r\n<h1>Set Default Language<\/h1>\r\nEach 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, select your preferred option from the drop down menu and click <strong>Save Changes<\/strong>.\r\n<div class=\"textbox shaded\">If you would like to select a default language option you do not see listed in the dropdown menu, please contact premium support.<\/div>\r\n<h1>Set Default PDF Page Size<\/h1>\r\nAt 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 <a href=\"https:\/\/guide.pressbooks.com\/chapter\/pdf-export-options\/#chapter-107-section-3\">theme options<\/a>. By default, the value is set to 'Digest (5.5\" x 8.5\")' for all Pressbooks networks.\r\n\r\nIf you would prefer for books to have a different default PDF page size value, you can change this value by selecting your preferred page size (or choosing <em>custom<\/em> and entering your desired values using CSS-compatible units like <code>in<\/code> or <code>em<\/code>) and clicking <strong>Save Changes<\/strong>.\r\n<h1><a id=\"iframe\"><\/a>Update Iframe Allowlist<\/h1>\r\nAn iframe is an HTML element which allows users to display an HTML document (i.e. an external 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, we prevent the embedding iframes from non-trusted sources into their books by default. However, Network Managers can manually allowlist trusted domains or paths. Once you have saved changes to your iframe allowlist, any iframe whose <code>src<\/code> attribute matches a domain or path on your allowlist can be added to a book by any author on your network.\r\n\r\nTo add a domain or path to your network iframe allowlist, paste the desired domain or path into the <strong>Iframe Allowlist field on its own line <\/strong>and click '<strong>Save Changes<\/strong>'. Guidelines for the expected input format are included below the input field.\r\n\r\nAn allowlisted domain or path must match the iframe <code>src<\/code> URL exactly in order for the iframe to properly embed and display. Please note that content cloned from other networks may include iframes from sources which have not been allowlisted on your network. If this is the case, these iframes will not display in the cloned book.\r\n\r\n<img class=\"size-full wp-image-64 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2022-03-18-15-52-38.png\" alt=\"\" width=\"1130\" height=\"158\" \/>\r\n<div class=\"textbox shaded\">\r\n\r\n<strong>Note: <\/strong>Pressbooks is compatible with any media that supports oEmbed. In addition, some media sources have been vetted and added to our global Pressbooks allowlist. Iframes from globally allowed sources can be embedded on any Pressbooks network by any user. This allowlist includes:\r\n<ul>\r\n \t<li><a href=\"https:\/\/phet.colorado.edu\">PhET Interactive Simulations<\/a><\/li>\r\n \t<li><a href=\"https:\/\/timeline.knightlab.com\">knight lab Timelines<\/a><\/li>\r\n \t<li><a href=\"https:\/\/www.brightcove.com\/en\/\">Brightcove videos<\/a><\/li>\r\n \t<li><a href=\"https:\/\/docs.google.com\/forms\/\">Google Forms<\/a><\/li>\r\n \t<li><a href=\"https:\/\/www.google.com\/maps\/\">Google Maps<\/a><\/li>\r\n<\/ul>\r\n<a href=\"https:\/\/guide.pressbooks.com\/chapter\/display-embedded-media\/\">Learn more about embedded media options<\/a> in Pressbooks.\r\n\r\n<\/div>\r\n<h1>Opt Out of Pressbooks Directory<\/h1>\r\nIf this option is <em>not selected <\/em>(the default setting), all public books in your Pressbooks network will be included in the Pressbooks Directory, unless a book admin chooses to opt-out of inclusion in the Directory. If this option is <em>selected<\/em>, only those books which network managers have chosen to display in a network's catalog will be flagged for inclusion in the Pressbooks Directory and individual book admins will not see any book-level opt-in options. This selection is not permanent and can be switched at any time.\r\n<div class=\"textbox shaded\"><strong>Note: <\/strong>We recommend leaving this setting unselected, in most cases, because this setting removes author agency and limits the wider public's ability to find and use public books. This option is most useful on Pressbooks networks where publication of all books is supervised closely by network managers and published books are consistently included in the network catalog upon publication.<\/div>\r\n<h1>Display Custom RSS Feed on User Dashboards<\/h1>\r\nThe Dashboard Feed option allows you to display an optional custom RSS feed on the user dashboard. You can use this to display news and updates from your library publishing program, or state wide open education updates, or any other RSS feed you think will be of interest to your users. To display a custom RSS feed, enter the desired Feed Title and Feed URL in the provided fields and click '<strong>Save Changes<\/strong>'\r\n<img class=\"size-full wp-image-65 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2022-03-18-16-01-04.png\" alt=\"\" width=\"782\" height=\"207\" \/>\r\n\r\nWhen configured, this feed will be added to the user dashboard, along with two default RSS feeds containing \u2018Pressbooks News\u2019 and \u2018Pressbooks Product Updates\u2019. The example below shows a custom RSS feed from Open Oregon (\u2018Open Oregon News\u2019).\r\n\r\n<img src=\"https:\/\/lh4.googleusercontent.com\/ynWPuK_O-edaWwy01b7-49HjKS1fjxc78Ker7xrU6JURLsnatieUXJOcrC9_OamdWnhYgSEgjnV3n39Q2xIa6o7MiXBirIXP08_AZ2eFVgMjnZX4mKy9VkkO_smaWrZQ0EtHkK2n\" alt=\"\" width=\"570\" height=\"500\" \/>\r\n\r\nThe settings page features a second tab titled 'Book &amp; User Registration'. The options presented on this tab are explained below:\r\n<h1>Allow registered users to create and clone new books<\/h1>\r\nAs 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 <strong>checked by default<\/strong> on Pressbooks networks, which means that registered users can create new books and clone books onto your network. <strong>If this box is unchecked<\/strong>, 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.\r\n<h1>Allow user self-registration<\/h1>\r\nAs 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 <strong>unselected by default<\/strong> on Pressbooks networks, which means that new user accounts can only be created by invitation.\r\n<div class=\"textbox shaded\"><strong>NOTE:\u00a0<\/strong>If you decide to allow user self-registration on your network, you should also use the <a href=\"#limit-email\">'limited email registrations' option<\/a> 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.<\/div>\r\nIf you'd like to enable user self-registration for your network, you can do so by checking this box, and clicking <strong>Save Changes<\/strong>. If checked, non-logged in visitors will see a <strong>Sign Up<\/strong> link next to <strong>Sign In<\/strong> when visiting the network home page (shown below).\r\n\r\n<img class=\"alignnone wp-image-66\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/sign-in-pressbooks-1024x209.png\" alt=\"Screenshot of Pressbooks home page with 'sign in' link visible next to 'sign up'\" width=\"803\" height=\"164\" \/>\r\n\r\nIf visitors to your network click the <strong>Sign Up<\/strong> link, they'll be taken to a user account registration page (shown below). In addition to account information, 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.\r\n\r\n<img class=\"alignnone wp-image-67\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2019-09-12-10-26-59.png\" alt=\"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.\" width=\"587\" height=\"651\" \/>\r\n<h1>Allow book administrators to invite new users as collaborators on their book<\/h1>\r\nAs 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 <strong>unchecked by default<\/strong>, which means that book admins will not see the <strong>Users<\/strong> 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.\r\n\r\nIf 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 checking this box and clicking <strong>Save Changes<\/strong>. When this option is selected, book admins will be able to invite existing and existing users to their books and select those <a href=\"https:\/\/guide.pressbooks.com\/chapter\/users\/\">users' roles within their book<\/a> from the <strong>Users<\/strong> menu from their book dashboard. Any new collaborators that book admins add to their individual books will also become users on your network once their accounts are confirmed.\r\n<h1><a id=\"limit-email\"><\/a>Limit Email Registrations<\/h1>\r\nAs 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 Pressbooks 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 <strong>Save Changes<\/strong>. Using the example provide above, you'd put <code>utopiastate.edu<\/code> on one line and <code>utopu.edu<\/code> on a second line, as shown in the screenshot below:\r\n\r\n<img class=\"size-full wp-image-68\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2019-09-12-09-56-24.png\" alt=\"Screenshot showing limited email domain registrations for utopiastate.edu and utopu.edu in Pressbooks\" width=\"712\" height=\"168\" \/>\r\n<div class=\"textbox\"><strong>Note:<\/strong> 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. These email limits apply to users added by any method - whether users try to self-register, or are invited by network managers or book administrators. This means that if your network were to use limited email registrations for <code>utopiastate.edu<\/code> addresses only, you could not invite a user with any other<code><\/code> email address to join your network, unless you removed the limited email registrations or added additional domains to your list of limited email registration domains.<\/div>\r\n<h1>Ban Email Domains<\/h1>\r\nAs 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 Pressbooks 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.\r\n\r\nTo ban email domains from being able to be registered on your site, enter each of the domains you wish to ban on its own line in the banned email domains field and click <strong>Save Changes<\/strong>.\r\n<h1>Send Email Notifications<\/h1>\r\nIf desired, you can send email notifications to one or more email addresses each time a new book or user is registered on your Pressbooks network. To send these notifications:\r\n<ol>\r\n \t<li>check the <strong>Send the network admin an email notification every time someone registers a site or user account<\/strong> box<\/li>\r\n \t<li>enter the email addresses you'd like to send these notifications to in the input field below, with one email per line <img class=\"size-full wp-image-69\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2019-09-12-10-23-15.png\" alt=\"Sample email notification setting in Pressbooks with two example email addresses provided.\" width=\"856\" height=\"246\" \/><\/li>\r\n \t<li>Click '<strong>Save Changes<\/strong>'<\/li>\r\n<\/ol>\r\n<h1>Require users to opt-in to terms of service at registration<\/h1>\r\n<div class=\"textbox shaded\"><strong>Note: <\/strong>This setting (and those that follow it) are only relevant if you've selected the <strong>Allow user self-registration<\/strong> option to allow users to self-register for accounts on your network.<\/div>\r\nWhen selected, the \"Require users to opt-in to terms of service at registration\" setting adds a check box requiring a user to accept your terms of service as part of their self-registration process.\u00a0The \"Terms of Service\" setting lets you select which page on your root network will serve as your network's terms of service. You must select '<strong>Require users to opt-in to terms of service at registration'<\/strong>\u00a0in order to select a terms of service page.\r\n\r\nYou can create a <strong>Terms of Service<\/strong> <strong>page<\/strong> at any time by following the instructions provided in the <a href=\"https:\/\/pressbooks.pub\/networkmanagerguide\/chapter\/add-edit-pages-on-your-network\/\">Add a Page<\/a>\u00a0chapter 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.\r\n\r\nTo set a terms of service page:\r\n<ol>\r\n \t<li>Create &amp; publish a terms of service page<\/li>\r\n \t<li>Select the title of the desired page from the dropdown menu in this setting<a style=\"orphans: 1; text-align: initial; font-size: 1em;\" href=\"https:\/\/pressbooks.com\/app\/uploads\/sites\/107677\/2019\/09\/Screenshot-from-2019-09-12-10-26-23.png\"><img class=\"size-full wp-image-70\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2019-09-12-10-26-23.png\" alt=\"Pressbooks network settings with terms of service page selected\" width=\"722\" height=\"182\" \/><\/a><\/li>\r\n \t<li>Click <strong>Save Changes<\/strong><\/li>\r\n<\/ol>\r\nIf you've checked this box and linked to a Terms of Service page, a terms of service 'opt-in' checkbox will be added to the default registration form, and must be selected before users can finish registering for their account. Users who attempt to register for new accounts will see a checkbox that states \"I agree to the Terms of Service\" on the registration page. This words 'Terms of Service' will link to your Terms of Service page.\r\n<img class=\"alignnone wp-image-365 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screen-Shot-2019-07-30-at-5.02.47-PM-1-e1647650246615.png\" alt=\"Registration form, terms of service opt-in highlighted\" width=\"677\" height=\"273\" \/>\r\n<h1>Customize Welcome Email and Welcome User Email Messages<\/h1>\r\nThese field contains the text of welcome emails sent to newly registered users under very specific conditions.\r\n\r\nThe <strong>Welcome Email<\/strong> 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 the confirmation email.\r\n\r\nThe <strong>Welcome User Email<\/strong> 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) the new user chooses <strong>not<\/strong> to create a book at the time of registration, and 4) that that user successfully activates their account by responding to a confirmation email.\r\n\r\nYou 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).\r\n\r\nYou can personalize either or both of these message, if desired. After making modifications, click the <strong>Save Changes<\/strong>\u00a0button at the bottom of the page.\r\n<h1>Send Events to Google Analytics<\/h1>\r\nAs a network manager, you're able to send visitor traffic information to a Google Analytics dashboard if you so desire.\r\n<div class=\"textbox shaded\">\r\n\r\n<strong>Note:<\/strong> All Pressbooks networks now include a <a href=\"https:\/\/pressbooks.pub\/networkmanagerguide\/chapter\/view-page-visit-and-referrer-statistics\/\">native integration with Koko Analytics<\/a>, which many users may prefer, since it requires no additional configuration, does not use any external services, and respects your visitors' privacy.\r\n\r\n<\/div>\r\nIf you would like to configure your Pressbooks network to send page view information to Google Analytics:\r\n<ol>\r\n \t<li>Use the Google Analytics dashboard and <a href=\"https:\/\/support.google.com\/analytics#topic=9143232\">create a new web 'property'<\/a> for your Pressbooks network (i.e. the URL of your network itself). Doing so will give you a Google Analytics ID for that property. (Please note that if your network currently uses a Universal Analytics property, going to the Admin view for it in the Google Analytics dashboard will lead you to a \u2018GA4 Setup Assistant\u2019; you will be able to set up a connected Google Analytics 4 property there, copy its ID (for example \u2018G-A123B4C5DE6\u2019), and enter it on this page.)<\/li>\r\n \t<li>Once this has been generated, paste this value <span style=\"font-size: 1em;\">in the relevant <\/span>Google Analytics ID field.\r\n<img class=\"alignnone size-full wp-image-259\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2019\/09\/ga4.png\" alt=\"\" width=\"2236\" height=\"312\" \/><\/li>\r\n \t<li>Click <strong>Save Changes<\/strong>.<\/li>\r\n<\/ol>\r\nOnce 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.\r\n\r\nBy default, all analytics data will be sent to the \"All Web Site Data\" view, and <strong>include data for all frontend and backend (admin) pages<\/strong>. This means the data for all the books on your network will be collected in the same place.\u00a0In some cases, network managers may want to give individual book authors direct access to the analytics data. This can be done in different ways, such as through filtered views or custom reports. Please refer to Google Analytics' documentation for instructions on configuring and using this optional third-party integration.\r\n<div class=\"textbox shaded\"><strong>Note:<\/strong> Pressbooks has added native support for Google Analytics 4. Since Universal Analytics will be deprecated by Google on July 1, 2023, it is recommended to add a Google Analytics 4 property and to use its ID in the Google Analytics 4 field on this page.<\/div>\r\n&nbsp;","rendered":"<p>As a network manager of a Pressbooks network, you can change several network configuration options to suit the needs of your institution or publishing program. To access your Network Options, click <strong>Settings<\/strong> from your Administer Network dashboard.<\/p>\n<h1>View Current Network Managers<\/h1>\n<p>This section displays a list of user names and email addresses for your current network managers and instructions for requesting a change to this list.<\/p>\n<h1>View LTI 1.3 connection usage<\/h1>\n<p>This section displays the number of students who have used the grade passback feature included in our optional <a href=\"https:\/\/pressbooks.pub\/networkmanagerguide\/part\/use-pressbooks-results-for-lms\/\">Results for LMS product add-on<\/a> and provides instructions for purchasing more student connections for your network, if desired.<br \/>\n<img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-63 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2019\/08\/Screenshot-from-2022-03-18-15-39-06.png\" alt=\"\" width=\"852\" height=\"141\" \/><\/p>\n<h1>Enforce Book Upload Space Quota<\/h1>\n<p>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 Pressbooks network. To enforce a size quota for individual books:<\/p>\n<ol>\n<li><strong>Click the check box<\/strong> in front of the &#8216;Limit total size of files uploaded to&#8217; prompt<\/li>\n<li><strong>Enter the per book quota size<\/strong> you&#8217;d like to impose (numerical values in megabytes or MB)<\/li>\n<li>Click <strong style=\"orphans: 1; text-align: initial; font-size: 1em;\">Save Changes<\/strong><span style=\"orphans: 1; text-align: initial; font-size: 1em;\">.<\/span><\/li>\n<\/ol>\n<div class=\"textbox shaded\">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 the following message: &#8220;Upload Limit Exceeded: Sorry, you have used your space allocation of ### MB. Please delete some files to upload more files.&#8221; when attempting to add new files. As a Pressbooks network manager, you can also monitor per book space usage with the <a href=\"http:\/\/networkmanagerguide.pressbooks.com\/chapter\/book-list\/\">book list<\/a> or network analytics <a href=\"http:\/\/networkmanagerguide.pressbooks.com\/chapter\/network-analytics\/\">stats<\/a> pages.<\/div>\n<h1>Set Max upload file size<\/h1>\n<p>By default, all Pressbooks networks impose a maximum file size upload limit of 25000 kB (25 MB). However, you can <em>reduce<\/em> this limit on your network if you wish. To do so enter your desired maximum file upload size in this field, expressed as kB (1000 kB = 1 MB) and click <strong>Save Changes<\/strong>.<\/p>\n<div class=\"textbox shaded\"><strong>NOTE:<\/strong> You cannot increase this limit above 25000 kB (25 MB) on Pressbooks 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.<\/div>\n<h1>Set Default Book Theme<\/h1>\n<p>While book administrators can select whatever theme they&#8217;d like to use for their books, each new book created on your network will have have your network&#8217;s default book theme applied when it is created.<\/p>\n<p>Pressbooks networks generally use Malala 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 your network&#8217;s default book theme, select your desired theme from this drop-down menu and click <strong>Save Changes<\/strong>.<\/p>\n<div class=\"textbox shaded\"><strong>NOTE:\u00a0<\/strong>Changing the network default book theme will not affect any <em>existing<\/em> books on your network. No matter which theme you select as your network default, book administrators can still apply any available theme to their book at any time.<\/div>\n<h1>Set Default Language<\/h1>\n<p>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, select your preferred option from the drop down menu and click <strong>Save Changes<\/strong>.<\/p>\n<div class=\"textbox shaded\">If you would like to select a default language option you do not see listed in the dropdown menu, please contact premium support.<\/div>\n<h1>Set Default PDF Page Size<\/h1>\n<p>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 <a href=\"https:\/\/guide.pressbooks.com\/chapter\/pdf-export-options\/#chapter-107-section-3\">theme options<\/a>. By default, the value is set to &#8216;Digest (5.5&#8243; x 8.5&#8243;)&#8217; for all Pressbooks networks.<\/p>\n<p>If you would prefer for books to have a different default PDF page size value, you can change this value by selecting your preferred page size (or choosing <em>custom<\/em> and entering your desired values using CSS-compatible units like <code>in<\/code> or <code>em<\/code>) and clicking <strong>Save Changes<\/strong>.<\/p>\n<h1><a id=\"iframe\"><\/a>Update Iframe Allowlist<\/h1>\n<p>An iframe is an HTML element which allows users to display an HTML document (i.e. an external 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, we prevent the embedding iframes from non-trusted sources into their books by default. However, Network Managers can manually allowlist trusted domains or paths. Once you have saved changes to your iframe allowlist, any iframe whose <code>src<\/code> attribute matches a domain or path on your allowlist can be added to a book by any author on your network.<\/p>\n<p>To add a domain or path to your network iframe allowlist, paste the desired domain or path into the <strong>Iframe Allowlist field on its own line <\/strong>and click &#8216;<strong>Save Changes<\/strong>&#8216;. Guidelines for the expected input format are included below the input field.<\/p>\n<p>An allowlisted domain or path must match the iframe <code>src<\/code> URL exactly in order for the iframe to properly embed and display. Please note that content cloned from other networks may include iframes from sources which have not been allowlisted on your network. If this is the case, these iframes will not display in the cloned book.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-64 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2022-03-18-15-52-38.png\" alt=\"\" width=\"1130\" height=\"158\" \/><\/p>\n<div class=\"textbox shaded\">\n<p><strong>Note: <\/strong>Pressbooks is compatible with any media that supports oEmbed. In addition, some media sources have been vetted and added to our global Pressbooks allowlist. Iframes from globally allowed sources can be embedded on any Pressbooks network by any user. This allowlist includes:<\/p>\n<ul>\n<li><a href=\"https:\/\/phet.colorado.edu\">PhET Interactive Simulations<\/a><\/li>\n<li><a href=\"https:\/\/timeline.knightlab.com\">knight lab Timelines<\/a><\/li>\n<li><a href=\"https:\/\/www.brightcove.com\/en\/\">Brightcove videos<\/a><\/li>\n<li><a href=\"https:\/\/docs.google.com\/forms\/\">Google Forms<\/a><\/li>\n<li><a href=\"https:\/\/www.google.com\/maps\/\">Google Maps<\/a><\/li>\n<\/ul>\n<p><a href=\"https:\/\/guide.pressbooks.com\/chapter\/display-embedded-media\/\">Learn more about embedded media options<\/a> in Pressbooks.<\/p>\n<\/div>\n<h1>Opt Out of Pressbooks Directory<\/h1>\n<p>If this option is <em>not selected <\/em>(the default setting), all public books in your Pressbooks network will be included in the Pressbooks Directory, unless a book admin chooses to opt-out of inclusion in the Directory. If this option is <em>selected<\/em>, only those books which network managers have chosen to display in a network&#8217;s catalog will be flagged for inclusion in the Pressbooks Directory and individual book admins will not see any book-level opt-in options. This selection is not permanent and can be switched at any time.<\/p>\n<div class=\"textbox shaded\"><strong>Note: <\/strong>We recommend leaving this setting unselected, in most cases, because this setting removes author agency and limits the wider public&#8217;s ability to find and use public books. This option is most useful on Pressbooks networks where publication of all books is supervised closely by network managers and published books are consistently included in the network catalog upon publication.<\/div>\n<h1>Display Custom RSS Feed on User Dashboards<\/h1>\n<p>The Dashboard Feed option allows you to display an optional custom RSS feed on the user dashboard. You can use this to display news and updates from your library publishing program, or state wide open education updates, or any other RSS feed you think will be of interest to your users. To display a custom RSS feed, enter the desired Feed Title and Feed URL in the provided fields and click &#8216;<strong>Save Changes<\/strong>&#8216;<br \/>\n<img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-65 alignnone\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2022-03-18-16-01-04.png\" alt=\"\" width=\"782\" height=\"207\" \/><\/p>\n<p>When configured, this feed will be added to the user dashboard, along with two default RSS feeds containing \u2018Pressbooks News\u2019 and \u2018Pressbooks Product Updates\u2019. The example below shows a custom RSS feed from Open Oregon (\u2018Open Oregon News\u2019).<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/lh4.googleusercontent.com\/ynWPuK_O-edaWwy01b7-49HjKS1fjxc78Ker7xrU6JURLsnatieUXJOcrC9_OamdWnhYgSEgjnV3n39Q2xIa6o7MiXBirIXP08_AZ2eFVgMjnZX4mKy9VkkO_smaWrZQ0EtHkK2n\" alt=\"\" width=\"570\" height=\"500\" \/><\/p>\n<p>The settings page features a second tab titled &#8216;Book &amp; User Registration&#8217;. The options presented on this tab are explained below:<\/p>\n<h1>Allow registered users to create and clone new books<\/h1>\n<p>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 <strong>checked by default<\/strong> on Pressbooks networks, which means that registered users can create new books and clone books onto your network. <strong>If this box is unchecked<\/strong>, 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.<\/p>\n<h1>Allow user self-registration<\/h1>\n<p>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 <strong>unselected by default<\/strong> on Pressbooks networks, which means that new user accounts can only be created by invitation.<\/p>\n<div class=\"textbox shaded\"><strong>NOTE:\u00a0<\/strong>If you decide to allow user self-registration on your network, you should also use the <a href=\"#limit-email\">&#8216;limited email registrations&#8217; option<\/a> so that self-registration is limited only to users with email addresses issued by your institution, per the terms of your institution&#8217;s agreement with Pressbooks.<\/div>\n<p>If you&#8217;d like to enable user self-registration for your network, you can do so by checking this box, and clicking <strong>Save Changes<\/strong>. If checked, non-logged in visitors will see a <strong>Sign Up<\/strong> link next to <strong>Sign In<\/strong> when visiting the network home page (shown below).<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-66\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/sign-in-pressbooks-1024x209.png\" alt=\"Screenshot of Pressbooks home page with 'sign in' link visible next to 'sign up'\" width=\"803\" height=\"164\" \/><\/p>\n<p>If visitors to your network click the <strong>Sign Up<\/strong> link, they&#8217;ll be taken to a user account registration page (shown below). In addition to account information, 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.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-67\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2019-09-12-10-26-59.png\" alt=\"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.\" width=\"587\" height=\"651\" \/><\/p>\n<h1>Allow book administrators to invite new users as collaborators on their book<\/h1>\n<p>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 <strong>unchecked by default<\/strong>, which means that book admins will not see the <strong>Users<\/strong> 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.<\/p>\n<p>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 checking this box and clicking <strong>Save Changes<\/strong>. When this option is selected, book admins will be able to invite existing and existing users to their books and select those <a href=\"https:\/\/guide.pressbooks.com\/chapter\/users\/\">users&#8217; roles within their book<\/a> from the <strong>Users<\/strong> menu from their book dashboard. Any new collaborators that book admins add to their individual books will also become users on your network once their accounts are confirmed.<\/p>\n<h1><a id=\"limit-email\"><\/a>Limit Email Registrations<\/h1>\n<p>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 Pressbooks 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 <strong>Save Changes<\/strong>. Using the example provide above, you&#8217;d put <code>utopiastate.edu<\/code> on one line and <code>utopu.edu<\/code> on a second line, as shown in the screenshot below:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-68\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2019-09-12-09-56-24.png\" alt=\"Screenshot showing limited email domain registrations for utopiastate.edu and utopu.edu in Pressbooks\" width=\"712\" height=\"168\" \/><\/p>\n<div class=\"textbox\"><strong>Note:<\/strong> 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. These email limits apply to users added by any method &#8211; whether users try to self-register, or are invited by network managers or book administrators. This means that if your network were to use limited email registrations for <code>utopiastate.edu<\/code> addresses only, you could not invite a user with any other<code><\/code> email address to join your network, unless you removed the limited email registrations or added additional domains to your list of limited email registration domains.<\/div>\n<h1>Ban Email Domains<\/h1>\n<p>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 Pressbooks network managers, but may be helpful if you permit book admins to add collaborators to their books, but don&#8217;t want them to invite collaborators with emails issued by a specific provider or organization.<\/p>\n<p>To ban email domains from being able to be registered on your site, enter each of the domains you wish to ban on its own line in the banned email domains field and click <strong>Save Changes<\/strong>.<\/p>\n<h1>Send Email Notifications<\/h1>\n<p>If desired, you can send email notifications to one or more email addresses each time a new book or user is registered on your Pressbooks network. To send these notifications:<\/p>\n<ol>\n<li>check the <strong>Send the network admin an email notification every time someone registers a site or user account<\/strong> box<\/li>\n<li>enter the email addresses you&#8217;d like to send these notifications to in the input field below, with one email per line <img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-69\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2019-09-12-10-23-15.png\" alt=\"Sample email notification setting in Pressbooks with two example email addresses provided.\" width=\"856\" height=\"246\" \/><\/li>\n<li>Click &#8216;<strong>Save Changes<\/strong>&#8216;<\/li>\n<\/ol>\n<h1>Require users to opt-in to terms of service at registration<\/h1>\n<div class=\"textbox shaded\"><strong>Note: <\/strong>This setting (and those that follow it) are only relevant if you&#8217;ve selected the <strong>Allow user self-registration<\/strong> option to allow users to self-register for accounts on your network.<\/div>\n<p>When selected, the &#8220;Require users to opt-in to terms of service at registration&#8221; setting adds a check box requiring a user to accept your terms of service as part of their self-registration process.\u00a0The &#8220;Terms of Service&#8221; setting lets you select which page on your root network will serve as your network&#8217;s terms of service. You must select &#8216;<strong>Require users to opt-in to terms of service at registration&#8217;<\/strong>\u00a0in order to select a terms of service page.<\/p>\n<p>You can create a <strong>Terms of Service<\/strong> <strong>page<\/strong> at any time by following the instructions provided in the <a href=\"https:\/\/pressbooks.pub\/networkmanagerguide\/chapter\/add-edit-pages-on-your-network\/\">Add a Page<\/a>\u00a0chapter in this guide. Once you&#8217;ve created and published the page you&#8217;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.<\/p>\n<p>To set a terms of service page:<\/p>\n<ol>\n<li>Create &amp; publish a terms of service page<\/li>\n<li>Select the title of the desired page from the dropdown menu in this setting<a style=\"orphans: 1; text-align: initial; font-size: 1em;\" href=\"https:\/\/pressbooks.com\/app\/uploads\/sites\/107677\/2019\/09\/Screenshot-from-2019-09-12-10-26-23.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-70\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screenshot-from-2019-09-12-10-26-23.png\" alt=\"Pressbooks network settings with terms of service page selected\" width=\"722\" height=\"182\" \/><\/a><\/li>\n<li>Click <strong>Save Changes<\/strong><\/li>\n<\/ol>\n<p>If you&#8217;ve checked this box and linked to a Terms of Service page, a terms of service &#8216;opt-in&#8217; checkbox will be added to the default registration form, and must be selected before users can finish registering for their account. Users who attempt to register for new accounts will see a checkbox that states &#8220;I agree to the Terms of Service&#8221; on the registration page. This words &#8216;Terms of Service&#8217; will link to your Terms of Service page.<br \/>\n<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-365 size-full\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2022\/10\/Screen-Shot-2019-07-30-at-5.02.47-PM-1-e1647650246615.png\" alt=\"Registration form, terms of service opt-in highlighted\" width=\"677\" height=\"273\" \/><\/p>\n<h1>Customize Welcome Email and Welcome User Email Messages<\/h1>\n<p>These field contains the text of welcome emails sent to newly registered users under very specific conditions.<\/p>\n<p>The <strong>Welcome Email<\/strong> 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 the confirmation email.<\/p>\n<p>The <strong>Welcome User Email<\/strong> 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) the new user chooses <strong>not<\/strong> to create a book at the time of registration, and 4) that that user successfully activates their account by responding to a confirmation email.<\/p>\n<p>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).<\/p>\n<p>You can personalize either or both of these message, if desired. After making modifications, click the <strong>Save Changes<\/strong>\u00a0button at the bottom of the page.<\/p>\n<h1>Send Events to Google Analytics<\/h1>\n<p>As a network manager, you&#8217;re able to send visitor traffic information to a Google Analytics dashboard if you so desire.<\/p>\n<div class=\"textbox shaded\">\n<p><strong>Note:<\/strong> All Pressbooks networks now include a <a href=\"https:\/\/pressbooks.pub\/networkmanagerguide\/chapter\/view-page-visit-and-referrer-statistics\/\">native integration with Koko Analytics<\/a>, which many users may prefer, since it requires no additional configuration, does not use any external services, and respects your visitors&#8217; privacy.<\/p>\n<\/div>\n<p>If you would like to configure your Pressbooks network to send page view information to Google Analytics:<\/p>\n<ol>\n<li>Use the Google Analytics dashboard and <a href=\"https:\/\/support.google.com\/analytics#topic=9143232\">create a new web &#8216;property&#8217;<\/a> for your Pressbooks network (i.e. the URL of your network itself). Doing so will give you a Google Analytics ID for that property. (Please note that if your network currently uses a Universal Analytics property, going to the Admin view for it in the Google Analytics dashboard will lead you to a \u2018GA4 Setup Assistant\u2019; you will be able to set up a connected Google Analytics 4 property there, copy its ID (for example \u2018G-A123B4C5DE6\u2019), and enter it on this page.)<\/li>\n<li>Once this has been generated, paste this value <span style=\"font-size: 1em;\">in the relevant <\/span>Google Analytics ID field.<br \/>\n<img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-259\" src=\"https:\/\/pressbooks.pub\/app\/uploads\/sites\/4747\/2019\/09\/ga4.png\" alt=\"\" width=\"2236\" height=\"312\" \/><\/li>\n<li>Click <strong>Save Changes<\/strong>.<\/li>\n<\/ol>\n<p>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.<\/p>\n<p>By default, all analytics data will be sent to the &#8220;All Web Site Data&#8221; view, and <strong>include data for all frontend and backend (admin) pages<\/strong>. This means the data for all the books on your network will be collected in the same place.\u00a0In some cases, network managers may want to give individual book authors direct access to the analytics data. This can be done in different ways, such as through filtered views or custom reports. Please refer to Google Analytics&#8217; documentation for instructions on configuring and using this optional third-party integration.<\/p>\n<div class=\"textbox shaded\"><strong>Note:<\/strong> Pressbooks has added native support for Google Analytics 4. Since Universal Analytics will be deprecated by Google on July 1, 2023, it is recommended to add a Google Analytics 4 property and to use its ID in the Google Analytics 4 field on this page.<\/div>\n<p>&nbsp;<\/p>\n","protected":false},"author":291,"menu_order":6,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"chapter-type":[],"contributor":[],"license":[],"class_list":["post-62","chapter","type-chapter","status-web-only","hentry"],"part":3,"_links":{"self":[{"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/pressbooks\/v2\/chapters\/62","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/wp\/v2\/users\/291"}],"version-history":[{"count":2,"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/pressbooks\/v2\/chapters\/62\/revisions"}],"predecessor-version":[{"id":64,"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/pressbooks\/v2\/chapters\/62\/revisions\/64"}],"part":[{"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/pressbooks\/v2\/parts\/3"}],"metadata":[{"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/pressbooks\/v2\/chapters\/62\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/wp\/v2\/media?parent=62"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/pressbooks\/v2\/chapter-type?post=62"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/wp\/v2\/contributor?post=62"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/integrations.pressbooks.network\/testampersands\/wp-json\/wp\/v2\/license?post=62"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}