{"id":28,"date":"2018-10-10T23:51:43","date_gmt":"2018-10-10T23:51:43","guid":{"rendered":"http:\/\/connectedcourses.stateu.org\/seeds\/collector\/28\/"},"modified":"2018-10-10T23:51:43","modified_gmt":"2018-10-10T23:51:43","slug":"setting-up","status":"publish","type":"post","link":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/cool\/setting-up\/","title":{"rendered":"Setting Up Your Image Collector SPLOT"},"content":{"rendered":"<p>Installed via Reclaim Hosting&#8221;s cpanel installer, this is a version of the <a href=\"https:\/\/github.com\/cogdog\/tru-collector\">TRU Collector<\/a> fully built out with many things that you would have to do to create a site like this from scratch.<\/p>\n<p>It helps you dive right into creating a pool of images or other things you might build a collection around.<\/p>\n<p>Once you have installed a copy of this into your own site, you have a few more things to do to get the pool going.<\/p>\n<p>Once you have done these, you can delete the earlier &#8220;Collectables&#8221; in the pool (the dog and the animated hamster), although you are welcome to keep them. You might want to edit this post, and under the Publish settings in the top right, change the status to <code>Draft<\/code>. That way, it will not appear on the site, but you can preview it from the Dashboard if you need to check these instructions.<\/p>\n<p>Also be sure to refer to the <a href=\"https:\/\/github.com\/cogdog\/tru-collector#setting-up-the-site-via-tru-collector-options\">theme&#8217;s set-up instructions<\/a> for help understanding the Theme Options.<\/p>\n<h2>WordPress Settings<\/h2>\n<p>Make sure you are logged into your site (add <code>\/admin<\/code>) to your URL. You can tell you are logged in if you see the black admin menu bar on top of every page your site. The following are some things you should do first to customize the site.<\/p>\n<ol>\n<li><strong>Make sure an Author Account is set up.<\/strong>\u00a0This is critical! Go to Users in the WordPress Dashboard, and if there is not an account named <strong>collector<\/strong> set one up (you can enter an email like <code>collector@yourdomain.com<\/code> it is never used). Set the account&#8217;s role to <code>author<\/code> (<a href=\"https:\/\/github.com\/cogdog\/tru-collector\/raw\/master\/wp-content\/themes\/tru-collector\/images\/add-author.jpg\" target=\"_blank\" rel=\"noopener\">see example settings<\/a>).Then go to a browser where you are not logged into this site, and try the link to Add a photo. If you get to the upload form, you are golden.<\/li>\n<li><strong>Customize the site and tagline<\/strong> Go to <code>Settings -&gt; General<\/code><\/li>\n<li><strong>Make Your Own Categories<\/strong> Go to <code>Collectables -&gt; Collectable Categories<\/code>. Delete the silly ones that come with this, and create your own meaningful categories.<\/li>\n<li><strong>Update the About Page<\/strong> Go to <code>Pages<\/code> and look for the About page. Make it describe your own site, not this one.<\/li>\n<\/ol>\n<h2>TRU Collector Options<\/h2>\n<p>Look for the link in the top admin bar to the options that further control how the site works. The Documentation tab explains (hopefully) the settings, but to summarize:<\/p>\n<ol>\n<li><strong>Access Code<\/strong> Enter a passphrase to provide a weak entrance requirement to post images. If a code is entered, anyone adding images to your pool will be sent to the Welcome Desk screen where they must enter the code to access the form for adding items.\n<ul>\n<li>If you do not use an access code, we suggest using the <strong>Status for New Items<\/strong> option to <code>Set to draft<\/code> so you can moderate content.<\/li>\n<li>If you do use an access code, we suggest using the <strong>Status for New Items<\/strong> option to <code>Publish immediately<\/code> so your site users can see their results right away.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<p>The rest of the options should be easy to see how they work. You can disable them from the Collection Add form, make them optional, or make them required depending on how much information you want to have people add to your site.<\/p>\n<p>Now try <a href=\"collect\" target=\"_blank\" rel=\"noopener\">adding an image to your pool<\/a>. Is that cool or what?<\/p>\n<h2>Customizing the Add to Collection Form<\/h2>\n<p>You can now customize the field labels and the descriptions of the form where people submit new items to a TRU Collector site. On your site navigate to the collect form, and activate the WordPress Customizer from the admin bar.<\/p>\n<p>There is a special section at the bottom to open:<\/p>\n<p><a href=\"https:\/\/github.com\/cogdog\/tru-collector\/blob\/master\/images\/customizer-tab.jpg\" target=\"_blank\" rel=\"noopener noreferrer\"><img class=\"aligncenter\" src=\"https:\/\/github.com\/cogdog\/tru-collector\/raw\/master\/images\/customizer-tab.jpg\" alt=\"\" \/><\/a><\/p>\n<p>Then from this pane, open &#8220;Collect Form&#8221; (eventually the theme options will live here too)<\/p>\n<p><a href=\"https:\/\/github.com\/cogdog\/tru-collector\/blob\/master\/images\/customizer-collect-tab.jpg\" target=\"_blank\" rel=\"noopener noreferrer\"><img class=\"aligncenter\" src=\"https:\/\/github.com\/cogdog\/tru-collector\/raw\/master\/images\/customizer-collect-tab.jpg\" alt=\"\" \/><\/a><\/p>\n<p>And then you will see a series of fields to edit for all form field elements. For each, you can edit the title\/label of the field and the prompt that appears below. As you type in the customizer fields on the left, you will see a live preview on the right (ignore the silly pizza references in the screenshot, the author was just hungry):<\/p>\n<p><a href=\"https:\/\/github.com\/cogdog\/tru-collector\/blob\/master\/images\/customizer-edit-form.jpg\" target=\"_blank\" rel=\"noopener noreferrer\"><img class=\"aligncenter\" src=\"https:\/\/github.com\/cogdog\/tru-collector\/raw\/master\/images\/customizer-edit-form.jpg\" alt=\"\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>Browse\/View By Reuse License<\/p>\n<p>The TRU Collector provides links that display archives of content that have the same reuse license (if the feature is activated via the TRU Collector options). Just make sure there is a WordPress Page with the url \/ slug\u00a0<code>\/licensed<\/code><\/p>\n<p><code><\/code>This page is created automatically on new sites, or simply by activating the theme again (activate the parent Fukasawa, then activate TRU Collector again). It only displays ones that have been used, and includes a count of the number of items in the collection using that license.<\/p>\n<p><a href=\"https:\/\/github.com\/cogdog\/tru-collector\/blob\/master\/images\/browse-licenses.jpg\" target=\"_blank\" rel=\"noopener noreferrer\"><img src=\"https:\/\/github.com\/cogdog\/tru-collector\/raw\/master\/images\/browse-licenses.jpg\" alt=\"\" \/><\/a><\/p>\n<p>This page (see\u00a0<a href=\"https:\/\/lab.cogdogblog.com\/collector\/licensed\" rel=\"nofollow\">example<\/a>) provides links to view all content with the licenses available on the collect form. The url including\u00a0<code>licensed\/cc-by<\/code>\u00a0yields all items with a Creative Commons CC By Attribution license\u00a0<a href=\"https:\/\/lab.cogdogblog.com\/collector\/licensed\/cc-by\" rel=\"nofollow\">example<\/a>.<\/p>\n<p>Use the page to find links to the ones you wish to use and add to your site&#8217;s menus or widgets. If the links do not work, you may have to go to\u00a0<strong>Settings<\/strong>\u00a0&#8212;\u00a0<strong>Permalinks<\/strong>\u00a0and just click save to regenerate the settings.<\/p>\n<h2>Adding Hyperlinks to Captions<\/h2>\n<p>Any HTML put into the editor for the caption is stripped out. But a new feature allows hyperlinks to be created using a &#8220;shortcode&#8221; format:<\/p>\n<p><a href=\"https:\/\/github.com\/cogdog\/tru-collector\/blob\/master\/images\/shortcode-link.jpg\" target=\"_blank\" rel=\"noopener noreferrer\"><img src=\"https:\/\/github.com\/cogdog\/tru-collector\/raw\/master\/images\/shortcode-link.jpg\" alt=\"\" \/><\/a><\/p>\n<p>Links show be entered as a\u00a0<code><\/code>\u00a0shortcode where the link\u00a0<code>url<\/code>\u00a0is specified as well as the\u00a0<code>text<\/code>\u00a0to be used as hypertext:<\/p>\n<p><code><a href=\"http:\/\/www.themostamazingwebsiteontheinternet.com\/\" target=\"_blank\">the coolest site on the internet<\/a><\/code><\/p>\n<p>This will create a hyperlink like\u00a0<a href=\"http:\/\/www.themostamazingwebsiteontheinternet.com\/\" rel=\"nofollow\">the coolest site on the internet<\/a><\/p>\n<p>To present the link just as a URL, simply use<\/p>\n<p><code><a href=\"http:\/\/www.themostamazingwebsiteontheinternet.com\/\" target=\"_blank\">http:\/\/www.themostamazingwebsiteontheinternet.com\/<\/a><\/code><\/p>\n<p>which will produce the hyperlink like\u00a0<a href=\"http:\/\/www.themostamazingwebsiteontheinternet.com\/\" rel=\"nofollow\">http:\/\/www.themostamazingwebsiteontheinternet.com\/<\/a>\u00a0&#8212; all links will open in a new window.<\/p>\n<p>If you want to give your site users more editing tools, enable the Rich Text Editor option in the TRU Collector Options.<\/p>\n<p>&nbsp;<\/p>\n<h2>Enable Public Ratings<\/h2>\n<p>Activating the\u00a0<a href=\"https:\/\/wordpress.org\/plugins\/wp-postratings\/\" rel=\"nofollow\">WP-Ratings Plugin<\/a>\u00a0that comes with this theme installed enables public star (or other scale) ratings on items from the front page, archives, and single items.<\/p>\n<h2>Fix Rotated Mobile Phone Photos<\/h2>\n<p>If contributors to your collection will be uploading photos directly from a smart phone, the\u00a0<a href=\"https:\/\/wordpress.org\/plugins\/ios-images-fixer\/\" rel=\"nofollow\">iOS Image Fixer plugin<\/a>\u00a0comes with this install enabled, so it can fix\u00a0<a href=\"https:\/\/wordpress.org\/plugins\/ios-images-fixer\/\" rel=\"nofollow\">problems associated with portrait mode photos that end up uploaded as sideways images<\/a>.<\/p>\n<p>Set up your own menus as needed; make sure that you click the\u00a0<code>Location<\/code>\u00a0tab to tell WordPress to use the menu you create.<\/p>\n<p><a href=\"https:\/\/github.com\/cogdog\/tru-collector\/blob\/master\/images\/menu.jpg\" target=\"_blank\" rel=\"noopener noreferrer\"><img title=\"menu options\" src=\"https:\/\/github.com\/cogdog\/tru-collector\/raw\/master\/images\/menu.jpg\" alt=\"Menu Configuration\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>Get rid of the default widgets on the site; make it your own<\/p>\n<p><a href=\"https:\/\/github.com\/cogdog\/tru-collector\/blob\/master\/images\/widgets.jpg\" target=\"_blank\" rel=\"noopener noreferrer\"><img title=\"suggested widget set up\" src=\"https:\/\/github.com\/cogdog\/tru-collector\/raw\/master\/images\/widgets.jpg\" alt=\"Widgets\" \/><\/a><\/p>\n<h2>Bonus Settings: Post By Email<\/h2>\n<p>If you want to add a feature to allow submissions to your site via email:<\/p>\n<ol>\n<li><strong>Install and activate the JetPack plugin<\/strong> Look for the link in the WordPress Dashboard under <code>Plugins<\/code>.<\/li>\n<li><strong>Enable the Post By Email option<\/strong> Check that this module is turned on in the JetPack settings.<\/li>\n<li><strong>Get an Address<\/strong> Go to your own account settings in WordPress, and look for the Post by Email Heading. Click the button to &#8220;generate an address&#8221;. This will create an email account that looks like <code>somemumbojumbo897@post.wordpress.com<\/code>. Copy the address, and paste it into the field to store this info in the Collector Options (this does no function, but provides you a place to store the password).Try sending an image to that address via email. Be prepared to be amazed.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>Read on to learn how to customize this site.<\/p>\n","protected":false},"author":0,"featured_media":27,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[3],"tags":[14],"splot_meta":{"author":"@cogdog","license":"pd","source":"Pixabay https:\/\/pixabay.com\/en\/pool-water-swimming-pool-refresh-831996\/"},"_links":{"self":[{"href":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/wp-json\/wp\/v2\/posts\/28"}],"collection":[{"href":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/wp-json\/wp\/v2\/comments?post=28"}],"version-history":[{"count":0,"href":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/wp-json\/wp\/v2\/posts\/28\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/wp-json\/wp\/v2\/media\/27"}],"wp:attachment":[{"href":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/wp-json\/wp\/v2\/media?parent=28"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/wp-json\/wp\/v2\/categories?post=28"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jdowna.wescreates.wesleyan.edu\/trucollector\/wp-json\/wp\/v2\/tags?post=28"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}