 Hey there, everybody who's tuning in. How's it going? Hey Taylor. Good, how are you doing? Pretty good. I just realized as starting my stream, I am out of coffee. Oh no. I'm locked in though. It's okay. And, but otherwise pretty good. So, what are we doing today? Oh boy. Well, today we are going to be working through getting press books up and running in Reclaim Cloud for me. And Taylor is going to be walking me through this as one would walk a child through tying their shoe laces. Because I really wouldn't know how to do this on my own. So, we wanted to take advantage of this learning opportunity and share it with whoever might be interested. Out there. Well, and I know you're being modest. So, what I want to mention is I spent a little bit of time mostly yesterday kind of just making sure we could do the press book specific things. I know you're relatively comfortable at the command line. So, that's going to be basically what we'll be doing today like from a process standpoint, we'll be deploying WordPress on Reclaim Cloud which is like a one click thing. And then doing a few command line things to have the press book stuff work. And so, it should be pretty straightforward. Like I said, I did some testing yesterday and that's what I'm bringing to this is the testing I did yesterday. Yeah, awesome. I'm really excited. I think it's going to be great. Let's do it. So, let's dig right in. I'm going to throw your screen up. So, Man is already logged into Reclaim Cloud of course. What I'm going to have you start with is just by using the marketplace button and we're going to use the, if you go to content management, we're going to use the WordPress standalone kit. And so, most of this stuff we can leave just by, as it is, but we are going to want to check the WordPress multi-site network button. Okay. Because press books has to work as a network, which I mean, given what it is, makes sense. And why don't you give it like a nicer URL? Yeah. Okay, and we can go ahead and hit install. And that's going to take four or five minutes in some cases. It's actually doing kind of a lot. The standalone kit is interesting in Reclaim Cloud because it is one node, so like one container. And it's setting up a database, setting up a Lightspeed web server, which is Lightspeed is like compatible with Apache, which is what we use on Domain and Zoneshared hosting and powers a lot of the web. Lightspeed is really good at caching though and making things super, super fast. It's doing all of that. It's going to do a multi-site network. And we are going to have to, after this goes in, do some things with the PHP version, do some things with the version of WordPress it's running and then install press books. So, but while it's doing that, do we want to maybe talk a little bit about press books generally? I mean, I imagine a lot of people who maybe are clicking on this, if anyone ever does, do know what press books is, but it's probably worth explaining what it is, what it's good for. Totally. So press books is an open source publishing platform, specifically for eBooks. It's a flavor of WordPress that is particularly good at making open educational resources, essentially specifically that are textbooks. And that's certainly how I'm familiar with it and how I used it in my first ever position post undergrad. I worked as an OER publishing coordinator for the State University of New York system. And that entire system was built around using press books. And what we loved about it was how not only does it have this great interface online for displaying an open textbook, but it also really helped us provide print versions of those textbooks for institutions that wanted them. I was working with 64 campuses across the SUNY system and some professors really wanted their students to have print access at least to print versions of their open textbooks that they were using in their classes. And so we were able to produce those using press books at a very low cost when we factored in the rest of our resources that produced those books. So it has been a little while since I've worked with press books. So now that I have this opportunity to kind of revisit it as a reclaim person, I am really excited to kind of dig into it and see if it's changed and see its potential beyond the very limited scope with which I was using it initially. Yeah, I think it's, I really love the like the ecosystem that potentially exists with something like press books. The fact that we can use this huge and powerful CMS like WordPress to make OERs and they can kind of build this system off the back of something like WordPress that is so pervasive, right? WordPress has got to be one of the largest open source projects just in general, not just web projects, right? So that's really cool and I also really dig some of the minutia, I don't have a ton of experience actually using press books, just a very small amount, but the ability to clone books from other press books instances and bring them into your instances, that is really awesome stuff that, honestly, I would love to have a feature like that that was just for WordPress proper, like could you, it would be amazing if you could take a page or a post in WordPress and say, this is cloneable and then someone could bring that in and do that for course content that- Well, I think that that's what's really cool about when like products that are working or platforms that are working within open source. So this is something that just seems to be thematic of what's going on in the open source. So I think it's a really powerful aspect of open systems. So the fact that press books offers that, I know that Commons in a Box open lab offers cloneability. I think it's a really powerful aspect of working open, as being able to kind of make sharing easier. For sure, for sure. So I think it's almost done. Actually, I'm pretty sure I can see that it is done, but before we actually get back to the install, I do wanna do one quick little overview of press books itself, instructions here. So we just kind of take a look at, you know, I mentioned already sort of our workflows can be we're gonna deploy WordPress, we're gonna do a couple of things, we're gonna install press books. But I just wanna kind of compare that here and talk a little bit about like generally the environment of running press books because there are a few things to know about. So this is press books own install guide and I have to do something really quick because I forget, I have this bug on my Mac where the pointer when I share my screen is never in the right place unless I do something. It's amazing. Love Mac OS. Do not like this bug I've had for years. For a year, I guess. Okay, now it's good. So, okay, so this is their install guide and basically the very core of press books is just you need a WordPress multi-site and then you do some stuff with it. So their instructions kind of include like, hey, use PHP 7.4 and then they say usually the most recent version of WordPress is supported that usually is doing a lot of work here. We'll talk about it a little bit later. And so their instructions are, all right, install WordPress from scratch and create enable multi-site mode and here's how you enable multi-site mode. So this whole part we can basically skip because we just did that in Reclin Cloud. You could also do this part in C-Panel in Installatron and you would mark the, hey, I want to do a multi-site. That's one of the options in Installatron. That would work. We are gonna have to, in my testing, I found that either PHP 7.4 or PHP 8.0 works. So in both C-Panel and Reclin Cloud, it's actually pretty easy to swap PHP versions. So I think we're gonna go with 7.4 just because that's what they have listed on their website and I did get that to work. There could be some thing later on down the line, probably not today, but maybe in a follow-up stream that if we're doing other things that maybe 7.4 is still preferred for some reason. So I'm gonna go with their recommendation there. And then I also found that PHP WordPress 6.1.2, I think is the version as of today is not supported. So we're gonna use 6.0.3. And I found that by digging through their plugin files and reading their code. I don't have that documented, unfortunately. But I think they do support maybe 6.1. I've heard from folks that it can work on that version too, but I'm just gonna go with what they have written somewhere for the moment. And part of what we're doing this today is so that we at Reclin can kind of learn a little bit more about, or at least like the two of us can learn a little bit more about what works and what doesn't properly. Once we have this set up in Reclin Cloud, it'd be really easy for us to duplicate it and make changes, see what breaks, stuff like that. So down the line. So then this part is stuff that we will do. This is the press book stuff. And really what it amounts to is installing a plugin and two themes, basically. Then it's just kind of some setup of what you want to call your press books site and stuff like that. This part, part three. This is not, we're not gonna get into this today. This, though, is important to note. This is the main reason why you might want to do this in Reclin Cloud and not in C-Panel. So press books to do, to make all of the non-web versions of your book. So PDF, EPUB, XML validation, I think has to actually do with copying books between press books and networks. All of these require a server that you have root access to to install these dependencies. And many of them also don't play super well in a C-Panel environment. We have experimented with that at Reclaim in the Past, but we've had issues with making sure that this stuff can stay up to date in the way it needs to and not conflict with other things that are happening on the server. So this is why if you want any of these export features and a lot of the stuff that makes press books unique other than the look and feel and the publishing experience, that will all get. This stuff, though, we're gonna wait on today. Basically, we just have to do a little bit more testing and see exactly. I don't wanna waste anyone's time on a stream with us trying and making mistakes for 45 minutes. I mean, sometimes that's all right, but today we're gonna stick with what we know. So, but because we're doing this Reclin Cloud, we'll have the ability to do this stuff down the line. And maybe we do a follow-up where we install these things in your press books install. So, yeah, so that's the whole thing. I'm gonna take my screen away here and we'll check out where you're at in Reclin Cloud. So, okay, so it's deployed, it's all done. There's the URL for it. You also should have gotten an email with this same stuff available. I'll say right now, Amanda, what I like to do is kind of copy this and put it in a text file somewhere or just pull your email up so you have it because we will need the credentials for logging into WordPress, of course. Okay, one second. I have to periodically blow into my mouth because my cat hair gets all over it. Okay, all right. All right, so you were saying I should copy which credentials? Yeah, you can copy the admin panel section or like if you have the email up, you can just, you don't have to bring it on screen, of course, right? And we will also change this after we're done with this string. Yes. Yeah, so cool. So why don't you just click the open in browser button? Okay. And we will, yep, it's working. So let's try log in here to this WordPress install. With those credentials that I saved. Okay. Awesome, so currently the way the standalone kit works on WordPress is it deploys 6.0. The installer for this gets updated periodically and it's not a big deal because you can always, we're not gonna do this right now, but you can always hit the please update now button and it will go to the latest version of WordPress. So Pressbooks wants 6.0.3. I tried on 6.0 and the plugin won't activate. So what we need to do is we need to manually update WordPress to 6.0.3 and there is, you can't do that in the WordPress interface. You hit update, it's gonna go to 6.1.1. So this is where we're gonna start with the terminal. So if you wanna close and you can open up the terminal in the app server node. App server node. Yeah, so. The terminal. There you go. And just for anyone who's watching, who's not familiar with Reclaim Cloud, if you hover over app server, this and then the node right below it, those are the same thing. I do not know why they label them that way. It seems like, it looks like it's two things, it is not. So it's weird. Good to know. Yeah, so I just wanted to point that out because it's one of those little oddities that's very strange. Ooh, I forgot, we have to do one thing before we even do this, I'm sorry. I took nodes, but they're not great. So there'll be a lot of, ooh, I forgots I think. We do have to change the PHP version. You can actually see under WordPress, it says 6.0.12, that's the WordPress version. Sorry, in the tags column, near the middle. And then it says PHP 8.1, we definitely can't use PHP 8.1. At least I don't think we can. So if you go up to the WordPress standalone kit, title, let's actually change that with the little pencil icon to something, press books or something, cool. And then the third button in, that is change environment topology. This is where we can change our PHP version. So if you change over on the right side, it says of, sorry, in the middle column, next to LLSMP, yep there, we can change PHP there. Change the tag and scroll down, we're gonna go with 7.4, 7.4.28. Like I said, I had tested it with 8.0, it does seem to work fine, but that's what they have documented, so we're gonna go with that. Okay. This'll take a little bit, because it's technically, it's kind of wild, the way Reclaim Cloud does things is, it's not actually reinstalling WordPress, because we checked that box that said keep volumes data, where WordPress is installed, it's a folder called, that's var, www, web root, it's actually leaving that alone. So like the database, not that we've done anything, right? But it's gonna leave it alone. What it's actually doing is it's reinstalling the operating system around that, which like completely, which is kind of wild to me as somewhat of a Linux nerd that is kind of wild that it can just do that. But so what it's doing is it's reinstalling the OS around it with one that has PHP 7.4 installed. So this will take another minute or so, maybe even two minutes, because it's kind of a big thing we're asking it to do. Unfortunately, there's no good way that I know of to tell it to do this when we first install it. You kind of have to, when you use the marketplace, yeah, when you use the marketplace installer, it's gonna assume you want the latest version of PHP. So it's just one limitation of the platform. But it is at least pretty straightforward to do. We don't have to actually like go into like the package manager and like uninstall PHP or anything like that. I was fully prepared to have to dig in to change the PHP. So it was very, very neat that we could just go into that topology interface and just do a little drop-down thing, press another button. That's what I like about Reclaim Cloud. It's a little scary because it's a little different, but for the last part, it's pretty straightforward. Yeah, honestly, Amanda, that's I spent a lot of time yesterday figuring out how to manually reinstall the PHP version before I found what I just showed you. Oh my. I did not know. And this is stuff like I get like sometimes folks in Discord will ask me Reclaim Cloud questions. And they're like, you're the expert. I'm like, I'm the expert. I'm learning. You're the expert learner. Yes, I'm very good at learning things and then being honest when I don't know things. So let's, this is a small suggestion. Let's take your terminal and move it up a little bit. So we got more room to see things when we make mistakes. Oh, that's weird. I guess hit reconnect. Oh yeah, because we just reinstalled the operating system. I guess that's fair. Yeah. Okay, so what we're going to do first is let's just go back to the tab you have WordPress in, just make sure everything's loading. Sweet, awesome. All right, let's go back to Reclaim Cloud. And what we're going to do is we're going to go to the web directory that WordPress installed in. So again, you can CD into var www. And it will need a slash at the front actually. Okay. And then it'll be web root slash root all caps. Cool. And if you just do an LS for a sanity check here, we can make sure there's WordPress, great. So the standalone kit has the WP command line tool installed which makes updating and changing versions of WordPress like one command instead of having to like manually go and download it and stuff. So that's really cool. So what we're going to do is WP space core, space update, and then space dash dash version. And then they equals and then 6.0.3, 6.0.3. That's it? Yeah, enter. There we go. So we just replaced version WordPress with 6.0.3. Let's go back to WordPress, make sure it is actually running that. There we go, learn more about the 6.0.3 version. Great. I guess we could also might as well do an upgrade network. I don't, there's no other sites in the network, but let's do it anyway. And I guess while we're here too, let's go and update our themes and plugins too. Oh my. None of which we're of course going to use, but it's fine. The plugins we will, not kismet so much, but the Lightspeed cache will leave enabled that works great and it makes everything extremely fast. So cool. We are all set and let's go back to Reclaim Cloud and now we're going to go and get the press book stuff. So I don't think I can, yeah, I'm going to switch over to my screen for a second. So they recommend going and getting the press books stuff and like uploading it there and unzipping it. We're going to do this all via the command line because it'll save us a lot of time. But what we do need to do is get the actual install URLs that we're going to have to download from and those are all in GitHub. And so I will, it's going to be great. It's going to be a lot of me reading you URLs. But instead of doing that actually, you know what I'll do is I'll just copy these links and I will put them in our own little private chat here in StreamYard so you can grab them. So the first thing we'll do is get press books itself. So this one is a plugin. So what we need to do is CD into WP-content and then CD into plugins. And then LS, I just, yeah. Do we need to do that? No, this is my paranoia. It's just a comfort thing. It's funny when I ask people to do things in the terminal, I realize my things that I do without thinking about them and LS enters just like in my brain apparently. So what we're going to do is we're going to use WGIT to download. We could use curl. WGIT is simpler when you just need to download a thing. So WGIT space and then if you want to paste in that URL I put in StreamYard. Can do. And enter. Okay, and now we're going to unzip it. So unzip is the command space and then if you just start typing P-R-E and then hit tab, it'll complete it and then enter. I'm going to go. Sweet. Okay, so now we'll LS again just to see what we got. Great. So it did install it to, or unzipped to its own little press books folder. So that's awesome. We actually can leave that exactly how it is. Let's get rid of the zip file just because. So if you want to R-M and then P-R and let it auto complete tab thing. Oh yeah, I guess. Because there's a folder called press books. Yeah, all right. And then hit enter. Great, so now let's go up a directory. If you want to CD dot dot. And then we're going to go into, oh actually, so one of the things I forgot in the press books documentation is they want us to go and, so it says copy the press books plugin. We also need it, there's an auto loader file that we need to make as a must use plugin. I think that's what MU stands for in WordPress Multi-Sites. So we have to make the MU plugins folder and then copy a final into it. So MK Durr. From where we are now in WP content? Yes. And then MU-plugins. And then enter. And then we're going to do CP. And then plugins slash press books slash HM. And then you can probably hit tab, yeah. And then we're going to go to MU-plugins. OK, now to do that, we're using the CP command. Do I just type in? Yeah, so you can literally type in MU-plugins now. And then slash HM-AutoLoader. This more autocomplete. There's nothing there, of course. Yeah, so this is all relative pass, right? Because we don't have a slash in front of it. We're saying we are in WP content. Go in the thing called press books, find this file, move it to this place. So yeah. Cool. All right. And yeah, let's go in that MU-plugins folder just to satisfy my anxiety. Great. That looks good. So let's go back up. And we're going to go into the themes folder next. OK. And to be clear, too, if someone was doing this and is not OK with command line at all for whatever reason, first I say, it's not that scary. I can do it. Yeah. And the great thing about doing it in something like Reclaim Cloud is, the worst case scenario, you have to delete some stuff. And then start over. That's the worst thing that can happen. But anyway, you could do this via SFTP. You could unzip everything on your computer and then use an SFTP client. We have documentation on using SFTP with Reclaim Cloud. It's a lot slower because SFTP is very slow when it's dealing with a lot of little files, and that's exactly what this is. So that's why we're doing it this way. Yeah, makes sense. Cool. All right, so now we're going to download the two press books themes. And one of them is called Book, and one of them is called Aldi, and that's the front end, I think. I don't actually know. It seems like that's what the front end is, but. Probably. Yeah. So let's start with Book. I'll get that link here. I just copied it. I'm going to throw it in our private chat so you can get access to it. And let's do W get that link. Great. Let's unzip that. That's just press books, books, or is it just? You can hit Tab from there, and it should grab it. And we're going to do the other one, too, which is, sorry, we just did Book, so I need Aldi now. Cool. I don't know that we've ever done StreamYard stuff, where we're flipping back between people's screens, but this actually works pretty nice. Yeah. So OK, so you just downloaded that one, too. Let's unzip that one. OK. Great. And then finally, let's get rid of our zip files. And so we can just do rmsstrisc.zip. So that'll get rid of all the zip files. Great. And let's ls to make sure we did everything. Looks good. Awesome. Looks good. One of the things that you mentioned in the press books documentation is that themes have to have theme name without a version number on the end of it. By the way, that they have zipped these up, that is already how they unzip, but just worth mentioning. You can't have pressbooks-ld.0012, so we're all good. But if someone was doing this via SFTP, that might be something they'd have to worry about. OK, so we are theoretically done with command line for now. So what we need to do is go back into WordPress. And I'm going to flip back over the instructions for a second. And so we're just going to have to network activate the pressbooks plug-in and do some stuff with themes. I'm not going to go through all this, because most of it's pretty straightforward, actually. But yeah, so network activate pressbooks theme. There we go. It's red. Beautiful. Oh, it's like home. And we also need to go to the themes. Yep, I was just checking for a second to make sure that we are actually in the network, not like a subset, right? That's where we are. OK, cool. And yeah, we're going to network enable Aldean and McLuhan. McLuhan. McLuhan. McLuhan. OK. So a couple of things, really, that's kind of it. Like we have pressbooks now. So the rest of this is they're having us going to settings and to look at our registration settings, which we will want to do. So for this, we probably don't want anyone to be able to register a account. But if you're doing a real one for an institution, you may want people to be able to log into it. So that those options are in there. There's all kinds of other options in here in terms of uploading size. That max upload file size is real small. But things that you would want to check out. The other thing it recommends is to go to the dashboard for our, not our network admin, but the network homepage. So that would be under Hello World and dashboard. So first of all, I guess we could change this, too. So if you go to settings and then, yeah, I probably want to change the site title. Cool. And so why don't you save that. And then we'll go to appearance. And we'll make sure that Aldean is already active. So yeah, let's go to the front end of the site and make sure it looks the way we expect. Sweet. Beautiful. So that's a basic press books install. We haven't added any books or anything, but that would be the next thing that you could do. But we're really done with the actual install part. Awesome. So thank you. Yeah, no problem. So I want to talk ahead, because I do want to do a follow-up stream at some point on the other stuff with press books. For sure. Definitely most people are going to want to get into this. We're not going to have time to do it today. But a couple things. So this is all under part three, the dependencies. When we return for another stream, when we've had more time to test some things, we'll probably do a clone of our press books install so that we can make sure that if we break anything, we don't have to actually reset up press books, or most likely I will do that when I'm testing. So I just wanted to mention that that's something we can do in Reclaim Cloud, is we can clone the environment, test in there, and then whenever works, we can replicate on our real press books install, right? Yeah. And so Prince XML is going to be the big one. That's for PDF export. My understanding is this version 12 is based on a little bit of asking around I've done that maybe that's not accurate. I've heard some folks say that 14.2 is a version you want to use. I'm not sure if there's an actual, like it doesn't work on 12, or it's just you could be using a newer version than 12. So that's something I'm going to have to test. EPUB checks, so that's for EPUB validation. And so that's something we'll look at here. XML validation, so xmlint, the one tricky thing with this is this is saying, hey, you can just install it with apt-get. That will work on Debian and Ubuntu for Linux distributions. We are not using that. The WordPress standalone kit we are using is it's kind of sent to us. It's not actually sent to us, but it's similar. So it has a different package manager. So that's going to be something I'm going to have to look at, is this package here actually available for us, or do we have to install it a different way? And theoretically, we could have done this all in Ubuntu or Debian, but then we would have had to actually, I think roughly 20 minutes this actually took us to do, with some explanation, would have been much longer because we would have had to spin up a Linux server, install and configure MariaDB or MySQL, install and configure Apache, install and configure PHP, manually install WordPress, set up a database, all of that we would have done, much slower process. So yeah, install and configure the network. So this ultimately, I think, long term is going to be a lot easier for us to recommend, say, hey, you can skip all of that. Do the install installation of WordPress, of Pressbooks, sorry, and then install these couple dependencies, and here's how you do that in this environment, I think is a much cleaner way forward for folks who would want to do this on ReClean Cloud. So this is the stuff we have to research a little bit. But yeah, I'm kind of excited. I'm excited that even just the basic Pressbooks without all of the fancy parts is relatively simple to get forward once we're running the right WordPress version and PHP version and everything. So it's pretty cool. Yeah, I'm super stoked. Yeah, so if anyone finds this useful, please let us know. And I don't have any plans yet, because it's all going to depend on when we can find version to test these things, time to test these versions of things, words. But at some point, we'll do a revisit and get all that fancy stuff set up. And don't worry, we will be back because this is something that I'm going to be hounding Taylor about, because. Sounds good. Yeah, so. Sweet. All right, well, I'm going to turn the stream off, but thanks to anyone who was watching. We did have some helpful stuff in the chat, so that was great. Yeah, and so you have ready next time.