https://mediawiki.middlebury.edu/LIS/api.php?action=feedcontributions&user=Ian+McBride&feedformat=atomLibrary & ITS Wiki - User contributions [en]2024-03-28T12:16:54ZUser contributionsMediaWiki 1.35.14https://mediawiki.middlebury.edu/LIS/index.php?title=Google_Analytics&diff=42291Google Analytics2022-12-22T15:54:12Z<p>Ian McBride: Replaced content with "Content for this wiki page has been moved to the TeamDynamix Knowledge Base: https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=540 Category:Analytics..."</p>
<hr />
<div>Content for this wiki page has been moved to the TeamDynamix Knowledge Base:<br />
<br />
https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=540<br />
<br />
[[Category:Analytics]]<br />
[[Category:Google Analytics]]<br />
[[Category:Content managers]]<br />
[[Category:LIS Website]]<br />
[[Category:GA]]<br />
[[Category:TDXKB]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=GitHub&diff=42290GitHub2022-12-22T15:44:26Z<p>Ian McBride: Replaced content with "Content for this wiki page has been moved to the TeamDynamix Knowledge Base: https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=539 Category:Git Cat..."</p>
<hr />
<div>Content for this wiki page has been moved to the TeamDynamix Knowledge Base:<br />
<br />
https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=539<br />
<br />
[[Category:Git]]<br />
[[Category:TDXKB]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=WRMC_Site&diff=42289WRMC Site2022-12-22T15:39:11Z<p>Ian McBride: Replaced content with "Content for this wiki page has been moved to the TeamDynamix Knowledge Base: https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=535 Category:TDXKB"</p>
<hr />
<div>Content for this wiki page has been moved to the TeamDynamix Knowledge Base:<br />
<br />
https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=535<br />
<br />
[[Category:TDXKB]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=PDF&diff=42288PDF2022-12-21T21:39:24Z<p>Ian McBride: </p>
<hr />
<div>=About PDFs=<br />
PDF is an acronym that stands for '''Portable Document Format'''. It is a standard format that was developed by the Adobe corporation for the purpose of creating documents that would look the same when viewed or printed on any computer system.<br />
<br />
PDFs have several advantages over Microsoft Word Documents as a format for distributing materials. First, PDFs are viewable on virtually all computing platforms without the need to purchase (or often install) additional software. Fonts and formating in a PDF document will look the same on all platforms. Printing will look the same on all platforms.<br />
<br />
PDF documents can be created by some software programs natively and by others using a 'Print to PDF' option.<br />
<br />
=Creating PDFs=<br />
==Adobe Acrobat==<br />
=='Print to PDF'==<br />
===Mac OS X===<br />
# In any program that supports printing, select '''File''' -> '''Print...'''<br />
# In the printing dialog, select '''Save as PDF'''<br />
===Windows===<br />
<br />
====Microsoft Print to PDF====<br />
On Windows 10 you can install the [https://www.digitaltrends.com/computing/print-pdf-windows/ "Microsoft Print to PDF" print-driver] and then choose it when printing.<br />
<br />
====Adobe Acrobat Print to PDF====<br />
If you have Adobe Acrobat installed, you can [https://helpx.adobe.com/acrobat/using/print-to-pdf.html choose "Adobe PDF" as the printer] in the print dialog.<br />
<br />
=Editing PDFs=<br />
==Adobe Acrobat==<br />
<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Git&diff=42287Git2022-12-21T21:39:02Z<p>Ian McBride: </p>
<hr />
<div>This page provides details on how LIS staff can use [http://git-scm.com/ Git] to collaborate and version-control their projects. [http://git-scm.com/documentation Excellent documentation on using Git] is available on the web, so this page focuses on our particular work-flows rather than basic usage.<br />
<br />
For those looking for more resources for learning Git, see:<br />
<br />
* [http://git-scm.com/documentation Git documentation]<br />
* [https://changelog.com/git-resources-for-visual-learners/ Git Resources for Visual Learners]<br />
<br />
= Recommended tools for working with Git =<br />
<br />
== OS X ==<br />
* [http://git-scm.com/download/mac Git] - The core Git command-line program and the Git-GUI user interface and the Gitk graphical history browser.<br />
* [http://sourcetreeapp.com/ Source Tree] - A nice GUI for working with Git.<br />
<br />
== Windows ==<br />
*[https://git-scm.com/download/win Git] - The core Git command-line program and the Git-GUI user interface and the Gitk graphical history browser.<br />
* [http://sourcetreeapp.com/ Source Tree] - A nice GUI for working with Git that includes helpers for managing SSH keys.<br />
<br />
== Linux ==<br />
* [http://git-scm.com/download/linux Git] - The core Git command-line program and the Git-GUI user interface and the Gitk graphical history browser.<br />
<br />
== Remote Linux hosts via X11 ==<br />
One common work-flow is to do your work on a remote Linux host from a Mac or Windows workstation. You will usually open a remote shell via Terminal (OS X) or Putty (Windows) so that you can get a command-line on the remote Linux host. If the Linux host has Git installed, you can use it's command-line interface through your terminal. Additionally, you can usually also use the graphical Git GUI and Gitk interfaces by running an X11 server on your workstation.<br />
<br />
The X11 has been around for decades and lets you easily run GUI programs across the network. X11 has an inverted client-server model from what most of us are used to: Your work-station runs an X11 'server' program that draws the GUI on your screen, while the X11 'client' is a program on the remote host that sends drawing commands to the server on your work-station.<br />
<br />
# Install the X11-server on your workstation.<br />
#* For OS X we recommend [http://xquartz.macosforge.org/landing/ XQuartz]. Note: the default ssh-x-forwarding time-out is low and can [http://b.kl3in.com/2012/01/x11-display-forwarding-fails-after-some-time/ cause your X programs to loose contact with the server]; add the following line to the Mac client’s /etc/ssh_config: <pre>ForwardX11Timeout 596h</pre><br />
#* For Windows we recommend _________.<br />
# Open a remote shell with SSH providing x-forwarding.<br />
#* On OS X run <pre>ssh -X user@host</pre> Your Terminal should automatically start XQuartz when you run ssh with the <code>-X</code> parameter.<br />
#* On Windows open Putty and _________.<br />
<br />
<br />
= Central Repositories =<br />
<br />
The <code>.git/</code> directory in your project is a full 'repository' and contains all of the changes sets that make up your project's history. It is perfectly fine to use git without ever interacting with remote services. That said, often we need to share our projects with others to collaborate as well as to make sure that our valuable efforts are backed up. To enable sharing, we push our change-sets from our local ''working repository'' to a ''central repository'' that is accessible by others in our 'team'. For our open-source development efforts that we share freely with the world, we use [https://github.com/middlebury GitHub] as our central-repository host as it aids collaboration with others outside of the institution.&nbsp;<br />
<br />
[[Category:Web Application Development]]<br />
[[Category:Git]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Directory_Support&diff=42286Directory Support2022-12-21T21:20:23Z<p>Ian McBride: </p>
<hr />
<div>Content for this wiki page has been moved to the TeamDynamix Knowledge Base:<br />
<br />
https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=536</code><br />
<br />
[[Category:TDXKB]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Directory_Support&diff=42285Directory Support2022-12-21T21:20:16Z<p>Ian McBride: Replaced content with "Content for this wiki page has been moved to the TeamDynamix Knowledge Base: https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=536</code>"</p>
<hr />
<div>Content for this wiki page has been moved to the TeamDynamix Knowledge Base:<br />
<br />
https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=536</code></div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Omeka&diff=42284Omeka2022-12-21T20:50:22Z<p>Ian McBride: Replaced content with "Content for this wiki page has been moved to the TeamDynamix Knowledge Base: https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=535 Category:Omeka C..."</p>
<hr />
<div>Content for this wiki page has been moved to the TeamDynamix Knowledge Base:<br />
<br />
https://support.gmhec.org/TDClient/47/middlebury/KB/ArticleDet?ID=535<br />
<br />
[[Category:Omeka]]<br />
[[Category:Public Search]]<br />
[[Category:TDXKB]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Omeka&diff=42283Omeka2022-12-21T20:46:13Z<p>Ian McBride: </p>
<hr />
<div>= Omeka =<br />
<br />
Omeka is a free, open source content management system for online digital collections. As a web application, it allows users to publish and exhibit cultural heritage objects, and extend its functionality with themes and plugins. A lightweight solution in comparison to traditional institutional repository software like DSpace and Fedora, Omeka has a focus on display and uses an unqualified Dublin Core metadata standard.<br />
<br />
= CAS Authentication =<br />
<br />
When the CAS authentication plugin is enabled, user-accounts are active on creation and do not require any activation link or email confirmation. The password reset screen has been overridden to prevent non-actions.<br />
<br />
You can add groups to Omeka, and all users will be individually added with the role that you assign upon creation.<br />
<br />
= Omeka Plugins =<br />
Only users with the site-super role can activate plugins.<br />
<br />
To activate a plugin:<br />
<br />
# Log on to your Omeka site by going to /admin, or click the "Log On" link at the tip right of your site, if the Login Bar plugin has been enabled.<br />
# Click the Plugins Link in the admin bar.<br />
# Locate the plugin you want to enable from the list, and click Install. This will redirect you to a configuration form, if it exists.<br />
<br />
== Bulk Metadata Editor ==<br />
Adds search and replace functionality allowing curators to update metadata fields over many records quickly and easily.<br />
==CAS Authentication ==<br />
Authenticates user via CAS single-sign-on and map user-attributes to roles. This is automatically enabled on all new Omeka sites.<br />
== COinS ==<br />
Adds COinS metadata to item pages, making them Zotero readable.<br />
== CSV Import ==<br />
Imports items, tags, and files from CSV files.<br />
== Digital Object Linker Plugin ==<br />
This plugin allows you to embed digital images from the external sources to be displayed on the item pages.<br />
== Docs Viewer ==<br />
Embeds a Google document viewer into item show pages. PDF documents, PowerPoint presentations, TIFF files, and some Microsoft Word documents are supported.<br />
== Exhibit Builder ==<br />
Build rich exhibits using Omeka.<br />
== Geolocation ==<br />
Adds location info and maps to Omeka<br />
== Hide Elements ==<br />
Hide admin-specified metadata elements.<br />
== Ldap ==<br />
Sign onto Omeka using your local LDAP. Based on the work done by Lehigh University.<br />
== Login Bar ==<br />
Displays a login bar at the top of a site for backend access.<br />
== Neatline ==<br />
Plot your course in space and time.<br />
== NeatlineFeatures ==<br />
Allows administrators to draw things on maps and associate them with an Omeka item.<br />
== Neatline Widget - SIMILE Timeline ==<br />
Add SIMILE Timeline to Neatline exhibits.<br />
== Neatline Widget - Text ==<br />
Connect text documents to Neatline exibits.<br />
== Neatline Time ==<br />
Create timelines in Omeka.<br />
== PDF Embed ==<br />
Embeds PDF documents into item and file pages.<br />
== Scripto ==<br />
Adds the ability to transcribe items using the Scripto library.<br />
<br />
The Scripto plugin requires a MediaWiki site to make API calls that allow the plugin to function. When installing the plugin, you are required to enter a valid [[MediaWiki]] API URL. A MediaWiki account must be created and its credentials entered in the Scripto settings to enable transcription editing. To request a new MediaWiki site, submit a [http://go.middlebury.edu/whd Helpdesk] ticket.<br />
== Search By Metadata ==<br />
Allows administrators to configure metadata fields to link to items with same field value<br />
== Shared Shelf Link ==<br />
Allows Shared Shelf users to publish image files and data records from a project in Shared Shelf, an online media management software from ARTstor, to Omeka collections. Shared Shelf is a subscription-based service.<br />
== Simple Pages ==<br />
Allows administrators to create simple web pages for their public site.<br />
<br />
[[Category:Omeka]]<br />
[[Category:Public Search]]<br />
[[Category:TDXKB]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Webform_Email_Templates&diff=42282Drupal Webform Email Templates2022-12-21T20:35:52Z<p>Ian McBride: </p>
<hr />
<div>The default email template for the Drupal [http://drupal.org/project/webform Webform module] will send out the date the form was submitted, the name of the person submitting the form (if they were logged in to the site) or their IP address, the value of each field in the form submission and a URL to a page on the site where the form submission can be viewed or edited. This information is usually sufficient, but you might want to have different fields sent to different people when the form is submitted, or provide a custom message to the person who submitted the form.<br />
<br />
To do this, you need to use the Custom Template feature which we will describe.<br />
<br />
= A Sample Form =<br />
<br />
For this documentation, we'll use the [http://go.middlebury.edu/web/feedback Web Feedback Form] as an example. The form has three fields: a textfield to collect a URL, a textarea to collect comments about the URL and an email field to collect the email address of the person submitting the form. '''In order to send an email to the person submitting the form, you need to use an email field rather than a text field.''' The email field will check to see if its value looks like a valid email address and warn the user if it is not.<br />
<br />
This is how the form appears to the user:<br />
<br />
[[File:Webform_Feedback_View.png]]<br />
<br />
This is how the Form Components screen appears to an editor:<br />
<br />
[[File:Webform_Feedback_Components.png]]<br />
<br />
By clicking on the Edit link to the right of one of the form components you can see the '''Label''' and the '''Field Key'''. The '''Field Key''' will be important when we are setting up the email template. It is a good idea to write down the '''Label''' and '''Field Key''' for each of your form components on a piece of scrap paper for reference as you create the email template.<br />
<br />
This is how the '''Label''' and '''Field Key''' appear on the Form Component editing form:<br />
<br />
[[File:Webform_Form_Component_Edit.png]]<br />
<br />
Here are the '''Label''' and '''Field Key''' values for our sample webform.<br />
<br />
<table><br />
<tr><br />
<th>Label</th><br />
<th>Field Key</th><br />
</tr><br />
<tr><br />
<td>Site URL</td><br />
<td>site_url</td><br />
</tr><br />
<tr><br />
<td>Comments</td><br />
<td>comments</td><br />
</tr><br />
<tr><br />
<td>Your Email</td><br />
<td>your_email</td><br />
</tr><br />
<table><br />
<br />
= Adding an Email to the Form =<br />
<br />
For this example, we will add an email to the Web Feedback Form that sends a confirmation message to the person who submitted the form. To do this, first navigate to the form page and then follow these steps:<br />
<br />
# Click the '''Edit''' link below the form.<br />
# Click the '''E-mails''' link in the '''Edit Console'''.<br />
# Click the radio button next to '''Component value''' and select the field on your form that collects the user's email. In our example this is the "Your Email" field.<br />
# Click the '''Add''' button.<br />
# In the '''E-mail subject''' area click the '''Custom''' radio button and enter the subject of the email that you would like to send to the user.<br />
# In the '''E-mail from address''' area click the '''Custom''' radio button and enter your email address or the email address for your department.<br />
# In the '''E-mail from name''' area click the '''Custom''' radio button and enter your name or the name of your department.<br />
# In the '''E-mail template''' area select '''Custom template''' from the drop-down menu.<br />
# In the '''E-mail template''' area enter the HTML text for your custom email. (see below)<br />
# Optionally, check the '''Include files as attachments''' checkbox.<br />
# Click the '''Save e-mail settings''' button.<br />
<br />
= The HTML E-mail =<br />
<br />
Custom emails are sent using HTML, which is the Hypertext Markup Language. While there are a lot of features of this markup, you don't need to know all of them. Here are examples of some common things you might want to do in your email.<br />
<br />
<table><br />
<tr><br />
<th>HTML</th><br />
<th>Text</th><br />
</tr><br />
<tr><br />
<td><pre><p>First Paragraph</p><p>Second Paragraph</p></pre></td><br />
<td><p>First Paragraph</p><p>Second Paragraph</p></td><br />
</tr><br />
<tr><br />
<td><pre>First Line<br />Second Line after Line Break</pre></td><br />
<td>First Line<br />Second Line after Line Break</td><br />
</tr><br />
<tr><br />
<td><pre>Regular Text, <b>Bold Text</b></pre></td><br />
<td>Regular Text, <b>Bold Text</b></td><br />
</tr><br />
<tr><br />
<td><pre>Regular Text, <i>Text in Italics</i></pre></td><br />
<td>Regular Text, <i>Text in Italics</i></td><br />
</tr><br />
<tr><br />
<td><pre>Regular Text, <u>Underlined Text</u></pre></td><br />
<td>Regular Text, <u>Underlined Text</u></td><br />
</tr><br />
<tr><br />
<td><pre><a href="http://www.middlebury.edu">Link to Middlebury</a></pre></td><br />
<td>[http://www.middlebury.edu Link to Middlebury]</td><br />
</tr><br />
<tr><br />
<td><pre><ol><li>First List Item</li><li>Second List Item</li></ol></pre></td><br />
<td><ol><li>First List Item</li><li>Second List Item</li></ol></td><br />
</tr><br />
<tr><br />
<td><pre><ul><li>First List Item</li><li>Second List Item</li></ul></pre></td><br />
<td><ul><li>First List Item</li><li>Second List Item</li></ul></td><br />
</tr><br />
</table><br />
<br />
= Token Values =<br />
<br />
Tokens can be used to replace part of your email template with information from the form submission. In Webforms 4, tokens can be selected from a dropdown list to be added to any custom field, including the E-mail subject field.<br />
<br />
To include a token, position your cursor in the desired field. Scroll down the page and click "Browse available tokens", which appears just below the E-mail template Text Area field. Select your desired tokens. For fields that you've created, you will have to enter that manually to replace a "?" in the token.<br />
<br />
Examples:<br />
<br />
<table><br />
<tr><br />
<th>Token</th><br />
<th>Description</th><br />
</tr><br />
<tr><br />
<td>[current-user:name]</td><br />
<td>The name of the user if logged in. Blank for anonymous users.</td><br />
</tr><br />
<tr><br />
<td>[current-user:mail]</td><br />
<td>The e-mail address of the user account. Blank for anonymous users.</td><br />
</tr><br />
<tr><br />
<td>[current-user:ip-address]</td><br />
<td>The IP address of the user. An IP address is like the address of a computer on a network. IP addresses beginning with 140.233 are from computers on the Middlebury network.</td><br />
</tr><br />
<tr><br />
<td>[site:name]</td><br />
<td>The name of the site (i.e. Middlebury)</td><br />
</tr><br />
<tr><br />
<td>[current-date:short]</td><br />
<td>The current date, in 'short' format. (07/30/2015 - 09:45)</td><br />
</tr><br />
<tr><br />
<td>[current-date:custom:?]</td><br />
<td>The current date in a custom format. See the [http://php.net/manual/en/function.date.php PHP documentation] for details.</td><br />
</tr><br />
<tr><br />
<td>[node:nid]</td><br />
<td>The node ID of the webform. Useful if you need to create a link back to the form.</td><br />
</tr><br />
<tr><br />
<td>[submission:sid]</td><br />
<td>The unique submission ID.</td><br />
</tr><br />
<tr><br />
<td>[node:title]</td><br />
<td>The title of the webform.</td><br />
</tr><br />
<tr><br />
<td>[submission:url]</td><br />
<td>The URL for viewing the completed submission.</td><br />
</tr><br />
<tr><br />
<td>[submission:values:?]</td><br />
<td>Webform tokens from submitted data. Replace the "?" with the "field key", including any parent field keys separated by colons. You can append:<br />
<ul><br />
<li>the question key for just that one question (grid components).</li><br />
<li>the option key for just that one option (grid and select components).</li><br />
<li>:nolabel for the value without the label (the default).</li><br />
<li>:label for just the label.</li><br />
<li>:withlabel for both the label and value together.</li><br />
<li>:key for just the key in a key|label pair (grid and select components).</li><br />
</ul><br />
</td><br />
</tr><br />
</table><br />
<br />
We will focus on this last token, since it provides the most flexibility for formatting your custom email template. The '''?''' in each is the value of the '''Field Key''' that we found when creating our sample webform. Using the '''[submission:values:?]''' token, we can create a custom email as follows:<br />
<br />
<pre><br />
<p>Thanks, for your feedback on our site at [site:url]!</p><br />
<p>We received the following comments from you, but we're always happy to hear more.</p><br />
<p>[submission:values:comments:withlabel]</p><br />
</pre><br />
<br />
Which will appear in the email like this:<br />
<br />
<code><br />
<p>Thanks for your feedback on our site at http://www.middlebury.edu!</p><br />
<p>We received the following comments from you, but we're always happy to hear more.</p><br />
<p><b>Comments:</b><br />This is a great website!</p><br />
</code><br />
<br />
Note the appended ''':withlabel''' value. With [submission:values:comments], only the value of the field appears in the email. With the appended ''':withlabel''' both the value of the field and the '''Label''' appear in the email.<br />
<br />
= Fieldsets =<br />
<br />
Though we don't use them in our example, you may have used the fieldset form component on your webform. Fieldsets also have '''Field Key'''s. To include the value of a form field that is inside a fieldset, you need to know both the '''Field Key''' of the fieldset and the form field. Let's say that our site_url field in the example was inside a fieldset which had a '''Field Key''' of site_information. The token for this field would be:<br />
<br />
*[submission:values:site_information:site_url]<br />
<br />
= Custom Email Subjects =<br />
<br />
You can also use tokens in the subject line of the email. For instance, entering this in the '''Custom''' field under '''E-mail subject'''<br />
<br />
<code>Web Feedback for %value[site_url]</code><br />
<br />
will send an email with this subject line<br />
<br />
<code>Web Feedback for http://www.middlebury.edu</code><br />
<br />
= Files and Attachments =<br />
<br />
In each Email configuration is the option to '''Include files as attachments'''. When this is checked, any uploaded files will be attached to the notification emails. While this can be a handy tool, please be aware that emails are significantly constrained in attachment size and email sending may fail if large attachments are submitted via the form.<br />
<br />
For forms that accept multiple or large attachments, uncheck the '''Include files as attachments''' option to ensure that notifications are sent. Instead of attachments, the email will include links to the submissions that will allow you to view and download the files.<br />
<br />
[[Category:Public Search]]<br />
[[Category:Drupal]]<br />
[[Category:Forms]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Webform&diff=42281Drupal Webform2022-12-21T20:35:38Z<p>Ian McBride: </p>
<hr />
<div>Part of the documentation on [[Drupal|Drupal]].<br />
<br />
We have set up new sites specifically dedicated to creating Webforms in a more secure, more up-to-date configuration. The process for creating and managing your Webforms is largely unchanged with the exception of the [[Drupal_Webform#Creating_a_Webform|Creating a Webform]], [[Drupal_Webform#Confirmation_Message|Confirmation Message]], and [[Drupal_Webform#Linking_to_your_Webform|Linking to your Webform]] sections.<br />
<br />
Drupal's webform module allows you to set up an online form to collect data and send information to you via email or by downloading an Excel spreadsheet. This should '''not be used to collect sensitive data'''. Please [https://www.middlebury.edu/office/information-technology-services/policies/information-security-policies/data-classification-policy review the sensitive data collection matrix] to determine whether this is an appropriate system for your data collection needs.<br />
<br />
{{Figure|'"`UNIQ--middmedia-00000001-QINU`"'|An overview of creating a basic Webform.}}<br />
<br />
&nbsp;<br />
<br />
= Creating a Webform =<br />
<br />
#If your department, office, or program does not already have a space for Webforms on forms.middlebury.edu or forms.miis.edu, we will need to do a little bit of work to create one for you so that it looks like your site on www.middlebury.edu or www.miis.edu and doesn't confuse visitors to your site. To request this, please [https://webhelpdesk.middlebury.edu/helpdesk/WebObjects/Helpdesk.woa/wa/TicketActions/new?rt=160 submit a Helpdesk ticket through the Web Helpdesk interface]. <br />
#Go to [https://forms.middlebury.edu/user https://forms.middlebury.edu/user] or [https://forms.miis.edu/user https://forms.miis.edu/user] depending on which site you are planning to add your form to and log in with the username and password that you would normally use to edit in [[Drupal|Drupal]]. <br />
#Type the address of your department, office, or program's forms site in the address bar. You will have received this address in the response to your Helpdesk ticket in step 1. <br />
#Create a new page for your Webform by clicking '''Add Sub-page''' in the '''Sub-pages''' section of the '''Edit Console''' at the top of the page. <br />
#In the '''Page name''' textbox, type in the title of your form, as you would like it to appear in the left navigation menu then click the '''Create sub-page''' button at the bottom of the page. <br />
#Click '''Add''' under '''Content''' in the Edit Console. <br />
#Select '''Webform''' from the list of content types in the middle of the page. <br />
#Enter a '''Title''' for your webform. <br />
#In the '''Body''' section, put any information that you would like to appear before the form, such an instructions. <br />
#Click '''Save''' <br />
<br />
See [[Drupal_Webform#Linking_to_your_Webform|Linking to your Webform]] for steps on creating a link from your department, office, or program site to this new form you've created, or the sections below in [[Drupal_Webform#Adding_Form_Components|Adding Form Components]] to add fields to your form.<br />
<br />
= Form Permissions =<br />
<br />
The setting of who can "read", or in this case submit, a piece of content in Drupal is made at the page level, rather than the content level. To ensure that your forms in Drupal can only be submitted by people with a Middlebury account:<br />
<br />
#Click '''Settings''' in the '''Page''' section of the '''Edit Console'''. <br />
#In the '''Permissions''' section of the page settings, make sure that the '''"Read"''' checkbox to the right of '''"Everyone"''' is unchecked. <br />
#Add the '''"institution"''' group to the Group permissions and '''give it only "Read"''' access. The "institution" group can be found within '''"Groups"''' and then '''"General"''' in the group menu. This group contains everyone at Middlebury, MIIS, the Language Schools, Schools Abroad, etc. You may wish to use a different group if you only want this visible to faculty, staff, and/or students, but "institution" is the go-to group for all Middlebury-related people. <br />
#Click the '''Save Settings''' button. <br />
<br />
= Editing a Webform =<br />
<br />
If you have permission to edit a form, an '''Edit''' link will appear at the bottom of the form. Once you click on that the '''Edit Console''' at the top of the page will change to have items related to editing the form. The first item, '''Edit''', will be selected by default and allows you to add a title and opening text for the form. The next item, '''Form Components''', can be used to add, modify, or remove fields from your form. See below for a description of each field.<br />
<br />
= Adding Form Components =<br />
<br />
After you click the '''Save''' button when creating a new Webform, you will be taken to the form components page. If you are editing an existing Webform, you can get to this page by clicking the '''Edit''' link at the bottom of the form and then clicking '''Form components''' in the Edit Console.<br />
<br />
To add a component:<br />
<br />
#Give the component a unique name. The name: <br />
#*Appears in bold above the interactive part of the component, followed by a colon. <br />
#Use the dropdown menu to choose the component type. <br />
#*Information on the 12 component types can be found below. <br />
#If you want the component to be mandatory for people submitting the form, make sure the "Mandatory" checkbox is marked. <br />
#If you want the submitted value of this component to be contained in email notifications, make sure the "E-mail" checkbox is marked. <br />
#Click the "Add" button. <br />
##You are now in the editing interface for the form component type you have chosen. <br />
#When you are finished setting up the component, click the "Submit" button. <br />
##You are returned to the "Form components" page. <br />
<br />
To edit an existing component, go to the "Form components" tab in the editing interface for you form and click the "Edit" link next to the component you wish to change. This will bring you to the appropriate form component editing interface.<br />
<br />
To reorder existing components, use the icons left of the component names to drag them into the correct order, then click the "Submit" button.<br />
<br />
All component types have 3 common fields in their editing interfaces. The "Label" field inherits the name you assigned in the steps above, and is displayed above the interactive piece of your component. The "Default value" field allows you to have parts of your form already filled in. The "Description" field allows you to provide more information for users and is displayed below the interactive portion of the component. The unique portions of each component editing interface are discussed below.<br />
<br />
== Date ==<br />
<br />
This component type provides a place for users to submit a date: month, day, and year. You have control over what time zone is used and how you want users to provide a year, either a dropdown list or a text field.<br />
<br />
== Email ==<br />
<br />
This component will give users a text field to provide a valid email address, and only properly formatted addresses will be accepted. You also have the option of sending a copy of the submission email to this address.<br />
<br />
If desired you can pre-populate the email address from the currently logged in user's information by checking the relevant box:<br />
<br />
[[File:User Email as default form value.png|500px|User email as the default form value]]<br />
<br />
== Fieldset ==<br />
<br />
{{Figure|'"`UNIQ--middmedia-00000002-QINU`"'|Video of basic fieldset use.}}<br />
<br />
This component allows you to group other components into boxes. You can choose to make each box collapsible. To put other components into a fieldset, when viewing the list of components, drag the component below the fieldset in the list and then to the right to indent it below the fieldset. [[File:Fieldset Indent.png|RTENOTITLE]]<br />
<br />
== File ==<br />
<br />
This component allows users to upload files with their submissions. You can control what file types are allowed, how large files can be, and where they are stored. '''Note: A "File" component must appear after the last "Pagebreak" component.'''<br />
<br />
== Grid ==<br />
<br />
This component provides a common set of "Options" for a list of "Questions." Options appear across the top, questions down the left. Each spot in the grid has a radio button, and only one option may be chosen for each question. You are able to randomize the order of the options, questions, or both.<br />
<br />
== Hidden ==<br />
<br />
This component can be used to store information not shown to users submitting the form.<br />
<br />
== Markup ==<br />
<br />
This component can be used to insert HTML code into your form.<br />
<br />
== Pagebreak ==<br />
<br />
This component is used to break your form into pages. The submit button will not be visible until a user completes the final page of the form. '''Note: If your form has a "File" component, it must appear after the last "Pagebreak" component.'''<br />
<br />
The Pagebreak also lets you set a '''Conditional rule''', which determines how people filling out the form will get to the page. This lets you have an answer to one question on your form lead to a set of other questions. This behavior is sometimes called '''branching logic'''. To use this, the Pagebreak must come after at least one other form component. To use this:<br />
<br />
#Expand the '''Conditional rules''' field on the Pagebreak form component configuration screen. <br />
#Select the '''Component''' whose value will determine whether to show the page. <br />
#Select either '''Is one of''' or '''Is not one of''' to determine whether to show the page. <br />
#Enter the '''Values''' that will determine whether to show this page. <br />
#Click '''Submit'''. <br />
<br />
== Select options ==<br />
<br />
This component allows users to respond to prompts. You can create single response questions (radio buttons, dropdown lists) as well as multiple response questions (checkboxes, multi-select lists).<br />
<br />
The Select options component features a GUI interface for adding options. If you want to revert to the manual method for editing options, click the '''Manual entry''' link below the option boxes. The value of each item can be entered in the text field contained in each row. If you want to be sent a different value for an option than appears for the user (ex. "One" appears on the form and you are sent "1"), click the '''Customized keys (Advanced)''' checkbox and enter the value you wish to be sent in the text field to the left of the value displayed to the user.<br />
<br />
The default option for this element can be set by clicking the radio button to the left of the appropriate value. Values can be rearranged by dragging the cross glyph to the left of these radio buttons. You can add a new row below any existing row by clicking the green cross glyph on the right and you can remove any row by clicking the red X glyph on the right. You can also choose to '''Randomize options''' by clicking that checkbox to display the options in a random order for each person visiting the form.<br />
<br />
If you want to allow people submitting the form to supply their own option if an appropriate one does not appear in the list, check the '''Allow "Other..." option and enter the appropriate text in the '''Text for "Other..." option'''text field.'''<br />
<br />
== Textarea ==<br />
<br />
This component provides a box for users to type in. You can make this box resizable.<br />
<br />
== Textfield ==<br />
<br />
This component provides a single-line text field for users to type in.<br />
<br />
If desired, you can supply default values from tokens. For instance the currently-logged-in user's first and last name can be added to a "Name" field using this token:<br />
<br />
<code>[current-user:field_first_name] [current-user:field_last_name]</code><br />
<br />
[[File:Firstname Lastname tokens.png|500px|First and last name via tokens.]]<br />
<br />
== Time ==<br />
<br />
This component type provides a place for users to submit a time. You can control what time zone is used, as well as whether to use 12-hour (am/pm) or 24-hour format.<br />
<br />
= Form Settings =<br />
<br />
This tab contains some of the advanced settings that were previously on the edit form. To get to this tab, after clicking '''Edit''' at the bottom of any Webform, click on the '''Webform''' tab in the '''Edit Console''' and then click on '''Form settings'''.<br />
<br />
== Who can read data submitted to this webform ==<br />
<br />
This section allows you to add individuals or groups to grant permission to view submissions to this webform without granting those people access to edit the form or other content on your site. Keep in mind that any people or groups added here will have access to both the submitted data as well as any files.<br />
<br />
Adding a person or group in this section does not automatically add them to the people who receive emails when the form is submitted. You must configure that separately as described in the [[Drupal_Webform#E-mails|E-mails]] documentation.<br />
<br />
== Confirmation Message ==<br />
<br />
You can, optionally, add a message to appear after a user submits the form. Leaving this blank gives a default message of completion after a user submits the form. It is '''highly recommended''' that you use this space to provide a link back to your site on www.middlebury.edu or www.miis.edu.<br />
<br />
== Redirection Location ==<br />
<br />
A custom redirect URL will bring a user to that page after submitting the form. If you need to create a brand new page to contain your custom confirmation message, you will want to create the page on www.middlebury.edu or www.miis.edu to add basic content. If you leave this blank or choose the confirmation message, the user will see that message instead. You can also choose not to redirect the user, which will reload the current form page when they submit the form.<br />
<br />
== Submission Limit ==<br />
<br />
This area allows you to limit user submissions. By default, a user can submit an unlimited number of responses, but you can restrict them to a specified number of submissions over a specified amount of time.<br />
<br />
== Advanced Settings ==<br />
<br />
You can ignore the '''Available as block''' and '''Show complete form in teaser''' checkboxes as the way we have set up the Middlebury website make these options unnecessary. The option of interest here is '''Allow users to save a draft'''. This option is only useful if your form requires users to sign in before filling it out. If you use this option on a form that allows anonymous users to submit it, it may behave erratically. However, if you require people to sign in to fill out your form and this option is selected, they will be allowed to save a draft of their form submission. This will not send emails from the form, but they will be able to come back to the form at a later time and complete their form submission. This is a good option if you have a very long form, especially one that requires people to gather written materials or files before they submit it.<br />
<br />
This section also allows you to change the text of the submit button, which is Submit by default.<br />
<br />
= E-mails =<br />
<br />
When editing the webform, under Webform -> E-mails, any email addresses specified in "E-mail to" will receive an email when the form is submitted.<br />
<br />
{{Figure|'"`UNIQ--middmedia-00000003-QINU`"'|This video describes:<br />
# sending email for each form submission<br />
# changing the recipient based on conditional values<br />
# creating a list of recipients to choose from}}<br />
<br />
See the [[Drupal_Webform_Email_Templates|article on Drupal Webform Email templates]] for more information.<br />
<br />
&nbsp;<br />
<br />
==== Email Resending ====<br />
<br />
By default emails will be resent whenever form submissions are updated.<br />
<br />
If you need to edit submissions after they are made and don't want emails going out for subsequent updates, you can uncheck the box under '''Form Settings''' » '''Submission Settings''' to "Re-send emails on update", as shown below:<br />
<br />
[[File:Resend Emails.png|frame|none|500px|Setting to change to halt email re-send on update]]<br />
<br />
= Form validation =<br />
<br />
Form validation allows you to create rules that will check the integrity of the data people have submitted. For example, if you have a field that collects a ZIP code, you may want to check that the value entered is between five and ten characters in length. If the person submitting the form enters a two digit ZIP code, they would receive a message letting them know of the issue and asking them to correct it and re-submit the form.<br />
<br />
To '''Add a validation rule''', click the '''Form validation''' tab in the Edit Console. Click on the type of rule to add to the form. There are explanations of each type of rule to their right. Enter a '''Rule name''', which is just seen by you and helps you remember why you added this rule to the form. Then select the '''Components''' to which this rule applies and fill in any other values that help create the rule.<br />
<br />
You can '''Edit''' or '''Delete''' existing validation rules by revisiting this tab at any time.<br />
<br />
= Results =<br />
<br />
In the '''Download''' tab for form '''Results''' there are two options that can help you when exporting form information to Microsoft Excel or another analysis program. '''Select list options''' allows you to choose whether to use human-readable or shorter column headers. You can also choose to export multi-values fields as separate columns or as a compact, comma-delimited list. In the '''Included export components''' fieldset, you can decide which of the components to include, which is helpful if you are only interested in analyzing a sub-set of the form information.<br />
<br />
If your webform accepted file uploaded, they will not be included in this export, but the CSV will have links to those files. If you would like to store the files locally, you can open the CSV and click on the links to download each of the submitted files to your local machine.<br />
<br />
= Linking to your Webform =<br />
<br />
To have a link to your new Webform appear in the left navigation menu of your site on www.middlebury.edu or www.miis.edu:<br />
<br />
#Navigate to your regular site on www.middlebury.edu or www.miis.edu and log in. <br />
#Click on '''Create sub-page''' in the '''Sub-pages''' section of the '''Edit console''' <br />
#In the '''Page name''' textbox, type in the title of your form, as you would like it to appear in the left navigation menu and the last portion of the URL from the address of your form on the forms site in the '''Page URL''' textbox (e.g. if your form is at [https://forms.middlebury.edu/academics/dept/spring-semester-form https://forms.middlebury.edu/academics/dept/spring-semester-form] enter "spring-semester-form" in the '''Page URL''' textbox) and click the '''Create sub-page''' button. <br />
#Click '''Add''' in the '''Contents''' section of the '''Edit Console'''. <br />
#Click the '''Redirector''' link in the center section of the page. <br />
#In the '''Destination URL''' textbox, enter the URL of the form on forms.middlebury.edu or forms.miis.edu and click '''Save'''. <br />
<br />
= Closing or Deleting a Webform =<br />
<br />
If you no longer need to collect information from your form, or if it is on www.middlebury.edu and you have already created a new version on forms.middlebury.edu, it is a good idea to close or delete the form. Doing this limits the chances that information from the form will be accidentally exposed, that the form will be used by spammers to flood your inbox, and will help our website perform better.<br />
<br />
== Backing up your Data ==<br />
<br />
Before closing or deleting a form, you can download a copy of the submissions that you can keep on [[MiddFiles|MiddFiles]]. See the [[Drupal_Webform#Results|Results]] section of this documentation for more information.<br />
<br />
== Closing a Webform ==<br />
<br />
Closing a Webform will prevent additional submissions to the form, though it will still appear on your site with a message letting people know that it is now closed. This is useful for forms that you want to temporarily disable, but will allow submissions to in the future. To activate this option:<br />
<br />
#Click '''Edit''' at the bottom of the Webform. <br />
#Click on '''Form Settings''' in the '''Edit Console'''. <br />
#In the '''Status of this form''' section, select '''Closed'''. <br />
#Click '''Save configuration'''. <br />
<br />
== Deleting a Webform ==<br />
<br />
If you no longer need the form, we would appreciate it if you would delete the content. You can do this by clicking '''Delete''' at the bottom of the Webform. This will move the Webform into a '''[Recycle Bin]''' page below the current page in the navigation menu. When the Webform is in the '''[Recycle Bin]''' editors can still access the data that was submitted to the Webform in the [[Drupal_Webform#Results|Results]] section, but new submissions will not be allowed and the form will not appear publicly on your site.<br />
<br />
If you are truly satisfied that you will no longer need the Webform, there is a '''Delete permanently''' option available after you have put the Webform in the Recycle Bin. Once the form has been deleted permanently, it cannot be recovered and all submitted data (including files) are removed from the website database.<br />
<br />
= Finding your Webforms =<br />
<br />
We provide two lists that Webform editors can use to locate all of the forms on www.middlebury.edu they are responsible for editing.<br />
<br />
[http://www.middlebury.edu/middlebury_my_webforms http://www.middlebury.edu/middlebury_my_webforms] will show all of the forms on the site that the currently logged in user has access to edit.<br />
<br />
[http://www.middlebury.edu/middlebury_our_webforms/###### http://www.middlebury.edu/middlebury_our_webforms/######] will show all of the forms within a particular area of the site. Replace the "######" with the page ID of the portion of the site you want to look at. The page ID is the number in parentheses in the Edit Console.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Forms]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Editing_in_Drupal:_Projects_for_Peace&diff=42280Editing in Drupal: Projects for Peace2022-12-21T20:35:24Z<p>Ian McBride: </p>
<hr />
<div>Part of the doucmentation on [[Drupal]] specific to [[Editing_in_Drupal|Editing]].<br />
<br />
The following information will show you how to add and edit projects in the Projects for Peace site. See the [[Editing_in_Drupal|Editing in Drupal]] article for general information on managing a Drupal site.<br />
<br />
= Loggin On =<br />
<br />
Before you can begin creating or editing content, you must first log on to the appropriate server.<br />
<br />
<ol><br />
<li>Navigate to any page on the site other than the home page</li><br />
<li>Scroll to the bottom of the left hand navigation and click the "Log On" link.</li><br />
<ol type="a"><br />
<li>You are now at the "Middlebury College Central Authentication Service."</li><br />
</ol><br />
<li>Your NetID and password are the same as for your Middlebury email account. Type them in the appropriate fields.</li><br />
<li>Click the "LOGIN" button</li><br />
<ol type="a"><br />
<li>You are returned to the page you were on.</li><br />
</ol><br />
<li>You may begin editing.</li><br />
</ol><br />
<br />
= Creating and Managing Projects =<br />
<br />
To simplify the information structure on the Projects for Peace site, all of the Projects are added directly to the Projects or International House page. They can be put elsewhere on the site, but this will make it easier to identify content for administrators. The process for creating and managing information for a project is described below.<br />
<br />
== Adding a Project ==<br />
<br />
<br />
<ol><br />
<li>Make sure you are logged on.</li><br />
<li>Navigate to the the [http://www.davisprojectsforpeace.org/projects| Projects] or [http://www.davisprojectsforpeace.org/international| International House] page, depending on the type of project you are adding.</li><br />
<li>Click File Uploads (hidden) in the left navigation menu. You will now upload any documents you have for the project.</li><br />
<ol type="a"><br />
<li>Find the "Edit Console" in the top left of your window. Click "Add".</li><br />
<li>Click "File Upload" in the center column of your screen.</li><br />
<li>For each file you want to upload, follow these steps.</li><br />
<ol type="a"><br />
<li>Enter the Title, which should be the same as the file name.</li><br />
<li>Click the Browse... button and locate the file on your hard drive, select it and click Open.</li><br />
<li>If you are adding another file, click the Add More button and repeat these steps.</li><br />
<li>To make finding files easier, we recommend the following naming convention. For project 999:</li><br />
<ul><br />
<li>Proposal: 999pro.pdf</li><br />
<li>Report: 999rep.pdf</li><br />
<li>Article: 999art1.pdf</li><br />
<li>Photo: 999photo.jpg</li><br />
</ul><br />
</ol><br />
<li>Click the Save button.</li><br />
</ol><br />
<li>Go back to either the [http://www.davisprojectsforpeace.org/projects| Projects] or [http://www.davisprojectsforpeace.org/international| International House] page, depending on the type of project you are adding.</li><br />
<li>Click on '''Add a New Project''' in the left navigation menu.</li><br />
<li>Find the "Edit Console" in the top left of your window. Click "Add".</li><br />
<li>Click "Project" in the center column of your screen.</li><br />
<li>Enter the project information as follows:</li><br />
<ol type="a"><br />
<li>Enter the name of the project in the "Project Working Title" field.</li><br />
<li>Enter the number of the project in the "Project #" field.</li><br />
<li>Enter the year of the project in the "Year" field.</li><br />
<li>Choose whether the project is a Project for Peace or an International House Project.</li><br />
<li>If the project is going to be featured on the home page of the site, click the Featured Project checkbox. NOTE: You should have a photo ready for the project and already uploaded if you select this.</li><br />
<li>Choose the country where the project is taking place from the Country drop down. NOTE: If this is a featured project, you must have already contacted Web Development and provided a map graphic for that country or had another featured project already from that country.</li><br />
<li>Enter the name of the school and a URL for its website (optional) in the School Name and School URL fields, respectively.</li><br />
<li>Enter a description (optional) of the project in the Project Description field. For featured projects, this is the text from the viewbook.</li><br />
<li>If you have uploaded a Proposal, begin typing the title you gave it when you uploaded it into the Proposal field and select from the listed files.</li><br />
<li>If you have uploaded a Report, begin typing the title you gave it when you uploaded it into the Report field and select from the listed files.</li><br />
<li>Enter the name of each student in the provided Students fields, one on each line. If you need to enter more than two students, click the Add another item button.</li><br />
<li>If you have uploaded an Article, begin typing the title you gave it when you uploaded it into the provided News Articles fields, one on each line. If you need to enter more than two articles, click the Add another item button.</li><br />
<li>If this is a featured project, begin typing the title you gave the photo for the project into the Image field and select from the listed files.</li><br />
<li>Click the Save button.</li><br />
</ol><br />
</ol><br />
<br />
== Modifying a Project ==<br />
<br />
<br />
<ol><br />
<li>Make sure you are logged on.</li><br />
<li>Navigate to the the [http://www.davisprojectsforpeace.org/projects| Projects] or [http://www.davisprojectsforpeace.org/international| International House] page, depending on the type of project you are modifying.</li><br />
<li>If you are adding files to a project, click File Uploads (hidden) in the left navigation menu.</li><br />
<ol type="a"><br />
<li>Find the "Edit Console" in the top left of your window. Click "Add".</li><br />
<li>Click "File Upload" in the center column of your screen.</li><br />
<li>For each file you want to upload, follow these steps.</li><br />
<ol type="a"><br />
<li>Enter the Title, which should be the same as the file name.</li><br />
<li>Click the Browse... button and locate the file on your hard drive, select it and click Open.</li><br />
<li>If you are adding another file, click the Add More button and repeat these steps.</li><br />
<li>To make finding files easier, we recommend the following naming convention. For project 999:</li><br />
<ul><br />
<li>Proposal: 999pro.pdf</li><br />
<li>Report: 999rep.pdf</li><br />
<li>Article: 999art1.pdf</li><br />
<li>Photo: 999photo.jpg</li><br />
</ul><br />
</ol><br />
<li>Click the Save button.</li><br />
</ol><br />
<li>Go back to either the [http://www.davisprojectsforpeace.org/projects| Projects] or [http://www.davisprojectsforpeace.org/international| International House] page, depending on the type of project you are adding.</li><br />
<li>Find the project in the list in the center column or if it is from a previous year, click on that year in the left navigation menu and then find the project in the list. Click on the name of the project, bringing you to the project page.</li><br />
<li>Click the "Edit" link below the project information in the center column.</li><br />
<li>Modify the project information as follows, as necessary:</li><br />
<ol type="a"><br />
<li>Enter the name of the project in the "Project Working Title" field.</li><br />
<li>Enter the number of the project in the "Project #" field.</li><br />
<li>Enter the year of the project in the "Year" field.</li><br />
<li>Choose whether the project is a Project for Peace or an International House Project.</li><br />
<li>If the project is going to be featured on the home page of the site, click the Featured Project checkbox. NOTE: You should have a photo ready for the project and already uploaded if you select this.</li><br />
<li>Choose the country where the project is taking place from the Country drop down. NOTE: If this is a featured project, you must have already contacted Web Development and provided a map graphic for that country or had another featured project already from that country.</li><br />
<li>Enter the name of the school and a URL for its website (optional) in the School Name and School URL fields, respectively.</li><br />
<li>Enter a description (optional) of the project in the Project Description field. For featured projects, this is the text from the viewbook.</li><br />
<li>If you have uploaded a Proposal, begin typing the title you gave it when you uploaded it into the Proposal field and select from the listed files.</li><br />
<li>If you have uploaded a Report, begin typing the title you gave it when you uploaded it into the Report field and select from the listed files.</li><br />
<li>Enter the name of each student in the provided Students fields, one on each line. If you need to enter more than two students, click the Add another item button.</li><br />
<li>If you have uploaded an Article, begin typing the title you gave it when you uploaded it into the provided News Articles fields, one on each line. If you need to enter more than two articles, click the Add another item button.</li><br />
<li>If this is a featured project, begin typing the title you gave the photo for the project into the Image field and select from the listed files.</li><br />
<li>Click the Save button.</li><br />
</ol><br />
</ol><br />
<br />
= Project Years =<br />
<br />
== Adding a new Year Page ==<br />
<br />
<ol><br />
<li>Make sure you are logged on.</li><br />
<li>Navigate to the the [http://www.davisprojectsforpeace.org/projects| Projects] or [http://www.davisprojectsforpeace.org/international| International House] page, depending on the type of project year you are adding.</li><br />
<li>Find the "Edit Console" and click "Settings".</li><br />
<li>Click Add sub-page.</li><br />
<li>Enter the numerical year as the Page name and URL name then click Create sub-page.</li><br />
<li>Find the "Edit Console" and click "Add".</li><br />
<li>Select "Basic Content" from the options in the center column.</li><br />
<li>Enter #### Projects in the Title field where #### is the numerical year.</li><br />
<li>Enter <code>[view:Projects==Project for Peace/####]</code> in the Body field where #### is the numerical year.</li><br />
<li>Expand the Appearance section.</li><br />
<li>Check the "Sticky at top of page" checkbox.</li><br />
<li>Click Save.</li><br />
</ol><br />
<br />
=== Add the File Uploads Page ===<br />
<br />
<ol><br />
<li>Click "Settings" in the "Edit Console".</li><br />
<li>Click Add sub-page.</li><br />
<li>Enter "File Uploads" as the Page name.</li><br />
<li>Enter "files" as the URL name.</li><br />
<li>Click Add sub-page.</li><br />
</ol><br />
<br />
== Changing the Year on the Projects Page ==<br />
<br />
<br />
<ol><br />
<li>Make sure you are logged on.</li><br />
<li>Navigate to the the [http://www.davisprojectsforpeace.org/projects| Projects] or [http://www.davisprojectsforpeace.org/international| International House] page, depending on the type of project year you are adding.</li><br />
<li>At the bottom of the center column, click the Edit link.</li><br />
<li>Find <code>[view:Projects==Project for Peace/####]</code> in the Body field where #### is the numerical year and change #### to the year you want to display.</li><br />
<li>Click Save.</li><br />
</ol><br />
<br />
= Featured Projects =<br />
<br />
Featured Projects have a photo and a map graphic for display on the home page of the site. We will describe how to create both of these. This required Adobe Photoshop. You should contact the Helpdesk to procure a copy of this application if you will be doing this work. Photoshop is also available on some lab machines. If you are working with a firm to put together the Viewbook, you should consider asking them to provide these items, using the steps below.<br />
<br />
== Feature Photo ==<br />
<br />
The feature photo is 525 pixels wide and has a variable height. To keep the home page content vertically balanced, you should keep the height of the feature photo between 250 and 350 pixels. The feature photo works best with a horizontally aligned image.<br />
<br />
<ol><br />
<li>Open the image you want to use in Adobe Photoshop.</li><br />
<li>Click the Rectangular Select tool.</li><br />
<li>Select the area of the image you want to use in the feature photo.</li><br />
<li>Click the Image menu and select Crop.</li><br />
<li>Click the Image menu and select Image Size.</li><br />
<li>Enter 525 in the Width field, choose pixels from the dropdown next to the Width field and click OK.</li><br />
<li>Click the File menu and select Save for Web & Devices.</li><br />
<li>Choose JPEG as the media type and High as the quality. Click Save.</li><br />
<li>Name the file ###photo.jpg where ### is the project number. Click Save.</li><br />
<li>Upload the file as described in the documentation above.</li><br />
</ol><br />
<br />
== Map Graphic ==<br />
<br />
The map graphic is 135 pixels wide and 135 pixels high. It features a border, filled in country, outlined political map of the region and oceans.<br />
<br />
<ol><br />
<li>Open Adobe Photoshop</li><br />
<li>Click the File menu and select New.</li><br />
<li>Enter 135 in the Width and Height fields and choose pixels from the dropdowns next to each field. Click OK.</li><br />
<li>Paste the map from the Viewbook into the new display. Center the map on the country for this project using the Select tool.</li><br />
<li>Set #d1e11d as your foreground color.</li><br />
<li>Click the Select menu and select All.</li><br />
<li>Click the Edit menu and select Stroke...</li><br />
<li>Enter 2 px in the Width field, select Inside under Location and click OK.</li><br />
<li>Using the Paint Bucket tool, fill in the country for this project with the foreground color.</li><br />
<li>Set #a2b9d3 as your foreground color.</li><br />
<li>Using the Paint Bucket tool, fill in the oceans and seas with the foreground color.</li><br />
<li>Click the File menu and select Save for Web & Devices.</li><br />
<li>Choose GIF as the media type and High as the quality. Click Save.</li><br />
<li>Name the file Country Name.gif where "Country Name" is the name of the country with spaces. Click Save.</li><br />
<li>Send these files to the Web Development group so that they can be added to the site.</li><br />
</ol><br />
<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Editing_in_Drupal&diff=42279Editing in Drupal2022-12-21T20:35:11Z<p>Ian McBride: </p>
<hr />
<div>Part of the documentation on [[Drupal|Drupal]].<br />
<br />
This page contains materials to help you edit content in Drupal. Information can be found for logging on, adding content, editing existing content, creating new pages, setting permissions, etc. Further, each set of instructions will be accompanied by a link to a step-by-step flash tutorial incorporating screen shots to help you complete each task.<br />
<br />
= Logging On =<br />
<br />
Before you can begin creating or editing content, you must first log on to the appropriate server.<br />
<br />
#Navigate to the page you wish to edit. <br />
#Scroll to the bottom of the left column and click the "Site Editor Log On" link. <br />
##You are now at the "Middlebury College Central Authentication Service." <br />
#Your NetID and password are the same as for your Middlebury email account. Type them in the appropriate fields. <br />
#Click the "LOGIN" button <br />
##You are returned to the page you were about to edit. <br />
#You may begin editing. <br />
<br />
= The Edit Console =<br />
<br />
If you are logged in and viewing a page in Drupal where you have editing permission, you will see a multicolored ribbon at the top of your screen with many different actions you can perform on the page. This will not show up when you are viewing a single piece of content, which you can tell because there will be the text '''node/######''' at the end of the URL in your brower's address bar (exception: the [[Drupal_Webform|Webform content type]] has its own edit console that will appear when viewing a webform node.<br />
<br />
The '''Edit Console''' has four sections:<br />
<br />
*'''Content''' (blue): These are actions you can perform on content on the current page. <br />
*'''Page''' (green): These are actions you can perform on the current page. <br />
*'''Sub-pages''' (reddish-orange): These are actions you can perform on sub-pages of the current page. <br />
*'''Help''' (purple): These are links to resources that offer editing assistance. <br />
<br />
== Content ==<br />
<br />
[[File:Drupal Edit Console Content.png|RTENOTITLE]]<br />
<br />
The items in this portion of the menu affect content on the current page, which will be the content currently displayed in the middle of your screen.<br />
<br />
=== View ===<br />
<br />
Clicking this link will bring you to the current page so that you can look and the content on that page.<br />
<br />
=== Add ===<br />
<br />
This allows you to add content to the current page. New content will be placed at the top of the page. Clicking this link will bring you to a page that lets you select the [[Editing_in_Drupal#Content_Types|Content Type]] to add.<br />
<br />
=== Reorder ===<br />
<br />
Each time you add or edit a piece of content, it is placed at the top of the page, above any other existing content. To get content to appear in the order you want, you must reorder it yourself. '''Note: If any content has been made sticky, it will always appear above all other content. If multiple pieces of content are sticky, you can reorder the sticky and non-sticky sections of your page separately.'''<br />
<br />
*Click the "Reorder" tab. The screen now shows the name and type of all content pieces on the page, each with the standard move icon to its left. <br />
*Use the icons to drag the content pieces into the order you want them to appear on the page. <br />
*When you're done, click the "Save configuration" button. <br />
*A message appears to notify you that the contents have been reordered. <br />
<br />
To change the order of items in a sidebar or other non-center content region, click on the "Edit" link above that region (or to the left for the Carousel) and follow the steps above.<br />
<br />
=== Files ===<br />
<br />
This can be used to locate content where an image or document is stored. Paste in the URL of the file on the Drupal site and click "Find!" You will be shown a list of content on the site that references that file. If the file was embedded in content since we upgraded to version 7.x-2.0-beta1 of the Drupal file_entity module (February 8 for www.middlebury.edu or October 23 for other Drupal 7 sites) you will also see a row for wherever it is being used.<br />
<br />
[[File:Drupal Edit Console Files.png|RTENOTITLE]]<br />
<br />
If you need to delete the file, click on the file title, then click "Delete" link -- this will move the file to the recycle bin. A "Delete" button can also be found at the bottom of the Edit form. To permanently delete the file, search for it again to find it in its recycle bin, then click delete a second time.<br />
<br />
== Page ==<br />
<br />
[[File:Drupal Edit Console Page.png|RTENOTITLE]]<br />
<br />
The items in this portion of the menu affect the current page and all content appearing on that page.<br />
<br />
=== Settings ===<br />
<br />
Page Settings refers to a page's properties. These include the name, URL, permissions, appearance, and location in the navigation bar.<br />
<br />
==== General Settings ====<br />
<br />
*'''Page Name''': This is the title of the page, as it will appear in the browser tab and in links to the page in search results. <br />
*'''URL''': This is the fragment of the site URL associated with this page. For example, the URL of the Offices & Services page on the Middlebury site is "offices" as it is located at [http://www.middlebury.edu/offices http://www.middlebury.edu/offices]. If you change the URL of a page after it has been created you may break user-created links to that page, though links in the site navigation will update automatically. <br />
<br />
==== Menu and Layout ====<br />
<br />
Click the ''Don't show this page in the menu'' to hide the link to the page in the navigation menu. '''This does not make the page password protected'''. You will need to change the page permissions for that. Pages which are hidden from the menu cannot be ordered in the menu; they will appear at the bottom of the menu list.<br />
<br />
*'''Location on screen''': See the [[Editing_in_Drupal#Page_Regions|Page Regions]] documentation. <br />
*'''Max number of child levels to display''' and '''Max number of parent levels to display''': As the user gets deeper down in the menu tree, higher-level entries will be removed. This keeps a deeply-nested menu from getting too indented. This setting is inherited by any sub-pages. <br />
<br />
==== Appearance ====<br />
<br />
This section allows you to set the page theme. There are several basic themes you can choose from. See the [[Drupal_Midd_Themes|Middlebury themes]] and [[Drupal_MIIS_Themes|MIIS themes]] documentation for more information about the available options.<br />
<br />
==== Archive ====<br />
<br />
Contents past a certain age will be automatically moved to a secondary page, where they are organized by date, if you choose to use an archive. This is useful for pages where you periodically post information about news and events. Selecting this will prevent you from ordering the items by hand, and instead have them displayed in reverse-chronological order.<br />
<br />
==== Meta Tags ====<br />
<br />
[http://en.wikipedia.org/wiki/Meta_element Meta Tags] can be used to supply additional information about your content to search engines and other programs accessing your content "behind-the-scenes". They are now shown on your page, but do appear in the HTML source of the page. The Meta Description is used by Facebook when you link to a page from that site. It is also often shown below the page link in search result pages in Google, Yahoo, and Bing.<br />
<br />
See the [[Drupal_Meta_Tags|Meta tags documentation]] for more information.<br />
<br />
==== Permissions ====<br />
<br />
Permissions determine what access users have to the page. These range from not even being able to access the page, all the way to full editing privileges. Information on the page level permissions hierarchy can be found at [[Monster_Menus_Permissions|Monster Menus Permissions]].<br />
<br />
The '''All users''' row refers to anonymous visitors to our site. To make a page password-protected, '''remove the Read permission''' from the '''All users''' row and add the groups you wish to have access. You are not allowed to give '''All users''' any permissions other than '''Reader'''.<br />
<br />
The '''Owner''' of a page is typically the person who created or last updated the page. Don't worry too much about who "owns" the page, unless you don't want that person editing it.<br />
<br />
We ''strongly recommend'' that you add '''Groups''' rather than '''Individuals''' to page permissions. This allows you to add and remove members using the [[AD_Group_Manager|Group Manager]] rather than managing them in Drupal, which is both faster and less error-prone.<br />
<br />
= Creating and Managing Pages =<br />
<br />
Most departments have had their architecture built out for them, but there are still pages that must be created. Where a page should appear within your architecture determines where it needs to be created. 2<sup>nd</sup> tier pages should be created from your main page, 3<sup>rd</sup> tier pages should be created from the 2<sup>nd</sup> tier page they supplement, and so on. If done properly, your new page will appear in the proper section of your navigation bar.<br />
<br />
== Adding a Page ==<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the parent of the page you are creating. <br />
#In the red-orange ''Sub-pages'' section at the top of your screen, click the "Add sub-page" tab. <br />
#Enter a name for your page in the "Page name" field. The name should be descriptive because: <br />
#*The page name is what appears at the top of your window. <br />
#*The page name appears in the navigation bar. <br />
#*The page name is used in compiling search results. <br />
#Enter a URL in the "URL" field. <br />
#*The URL determines the web address for the page. <br />
#Scroll down and click the "Create sub-page" button. <br />
##The screen now shows your blank page and asks you to add content. <br />
<br />
== Copying/Moving a Page ==<br />
<br />
To copy or move a page, navigate to the page, then click Copy/Move in the green "Page" section. Select the Mode, then choose the Destination where you want to copy or move the page. You can give the page a new name and URL.<br />
<br />
== Page Regions ==<br />
<br />
Most of the content you create will be added to the "content" region in the middle of the page. However, you can add other editable regions to your pages, enabling you to use more of the space on this design.<br />
<br />
=== New sub-section ===<br />
<br />
Creates a new left navigation menu section and makes the page the top page of the section.<br />
<br />
=== Sidebar ===<br />
<br />
Sidebar content is created using the "Text for Right Column" block. This block will look up in the page tree until it finds a page with content in the block. That content will then be displayed at the current level of the tree. To override Text for Right Column content from a higher level in the tree, create a new page at the current level with this menu appearance.<br />
<br />
For example, if this is your site hierarchy the content on the rightcolumn page will be displayed in the sidebar of all three departments:<br />
<br />
*Home <br />
**Academics <br />
***rightcolumn (Using Text for Right Column menu appearance) <br />
***Biology <br />
***Chemistry <br />
***Economics <br />
<br />
To create a custom sidebar for Chemistry, create a new rightcolumn page at that level:<br />
<br />
*Home <br />
**Academics <br />
***rightcolumn (Using Text for Right Column menu appearance) <br />
***Biology <br />
***Chemistry <br />
****rightcolumn (Using text for Right Column menu appearance) <br />
***Economics <br />
<br />
To create a page using this menu appearance:<br />
<br />
#Navigate to the level in the site information architecture where you wish to create sidebar content. <br />
#Click Add sub-page <br />
#Enter a page name. We recommend "Sidebar Content", but you may use whatever name you like.<br/> '''**NOTE: If the page name already has a name, go back and click on the ADD&nbsp;SUB-PAGE TAB.''' <br />
#Enter a URL name. We recommend "sidebar", but you may use whatever name you like.<br/> '''**NOTE: If it already has a url, go back and click on the ADD SUB-PAGE TAB.''' <br />
#Expand Menu and layout. <br />
#Under "Location on screen" choose "Text for right column". <br />
#Make other page settings, such as Permissions as you normally would for a new page. <br />
#Click Create sub-page. <br />
<br />
You can now add content to the sidebar using content types as you normally would for page content. The content you add here will be displayed in the Sidebar. You should also now see an Edit link in the Sidebar. This will allow you to return to content editing for Sidebar content at this level and any other where this Text for Right Column page will be displayed.<br />
<br />
=== Carousel ===<br />
<br />
Created using the "Carousel" block, this region displays content in a scrolling bar at the bottom of the page. This block will look up in the page tree until it find a page with content in the block. That content will then be displayed at the current level of the tree. To override Carousel content from a higher level in the tree, create a new page at the current level with this menu appearance.<br />
<br />
For example, if this is your site hierarchy the content on the rightcolumn page will be displayed in the sidebar of all three departments:<br />
<br />
*Home <br />
**Academics <br />
***carousel (Using Carousel menu appearance) <br />
***Biology <br />
***Chemistry <br />
***Economics <br />
<br />
To create a custom sidebar for Chemistry, create a new carousel page at that level:<br />
<br />
*Home <br />
**Academics <br />
***carousel (Using Carousel menu appearance) <br />
***Biology <br />
***Chemistry <br />
****carousel (Using Carousel menu appearance) <br />
***Economics <br />
<br />
To create a page using this menu appearance:<br />
<br />
#Navigate to the level in the site information architecture where you wish to create carousel content. <br />
#Click Settings <br />
#Click Add sub-page <br />
#Enter a page name. We recommend "Carousel", but you may use whatever name you like. <br />
#Enter a URL name. We recommend "carousel", but you may use whatever name you like. <br />
#Expand Appearance. <br />
#Expand Menu appearance. <br />
#Under "Location on screen" choose "Carousel". <br />
#Make other page settings, such as Permissions as you normally would for a new page. <br />
#Click Create sub-page. <br />
<br />
You can now add content to the carousel using content types as you normally would for page content. The content you add here will be displayed in the Carousel. Scroll to the left edge of the Carousel to see the Edit link for the Carousel. This will allow you to return to content editing for content at this level and any other where this Carousel page will be displayed.<br />
<br />
If you use the "File Upload" content type to place an image in the Carousel, text cannot be added around the image.<br />
<br />
To add an image to the Carousel with additional text:<br />
<br />
#Navigate to the Carousel Editor <br />
#Add a "Basic Content" type. <br />
#Provide a title for the content. If you do not wish to have this title show in the Carousel, place the title in between a set of brackets. Example: [Title] <br />
#In the WYSIWYG editor, Embed the image in the editor using the directions provided at the following link: [http://mediawiki.middlebury.edu/wiki/LIS/Drupal_File_Upload#Embedding_in_Other_Content http://mediawiki.middlebury.edu/wiki/LIS/Drupal_File_Upload#Embedding_in_Other_Content]. Note: If you previously uploaded your image, it may appear in another File Upload folder depending on which level the image was added. <br />
#You can adjust the size of the image once it has been placed in the WYSIWYG editor by selecting the image and moving the corners to the size you require. <br />
#Add the text that you wish to add around the image within the WYSIWYG editor. <br />
#If you wish to include text but need to adjust the alignment of the image within the editor: <br />
##Click on the image so that it is selected <br />
##Click the Insert/Edit Image button. This button will look like a tree and will appear to the right of the overlapping mountains you used for uploading the image. <br />
##In the Insert/Edit Image window, you will see an Appearance tab. In this tab, you can adjust the alignment of the photo as well as other style attributes. <br />
<br />
&nbsp;<br />
<br />
=== Banner image ===<br />
<br />
Like the regions above, banner images can be added by creating a sub-page and assigning it to the "Site Banner" region:<br />
<br />
[[File:SiteBanner.png|frame|SiteBanner.png]]<br />
<br />
Once you have created the sub-page for the site-banner, you can add an image as File-upload content and it will display with no further action.<br />
<br />
To do this:<br />
<br />
*Select "Edit" to edit the site banner sub-page. <br />
*You should now be located in the site banner page and will see that reflected in the path at the top of your content area <br />
*You will go up to the content editor at the top of the screen and click "Add" to add your image. <br />
*Select "File Upload" from the available content types to upload the banner image you wish to add to the banner site <br />
*Save and you should have successfully added your banner image. <br />
<br />
<br/> &nbsp;<br />
<br />
= Content Types =<br />
<br />
Drupal organizes information into '''Content Types''', which have a unique list of fields and a distinct way to display the content. For example, a content type for a news story might have fields for a title, the body of the story, and a dateline. A content type for a user profile might have fields for the person's job title, email address, and telephone number. Drupal organizes the information in these fields and displays them on the site.<br />
<br />
This section describes each of the types of content available on our site.<br />
<br />
#[[Drupal_Basic_Content|Basic Content]] <br />
#[[Drupal_Course_Listing|Course Listing]] <br />
#[[Drupal_Event|Event]] <br />
#[[Drupal_Facebook_Element|Facebook Element]] <br />
#[[Drupal_File_Upload|File Upload]] <br />
#[[Drupal_FAQ|Frequently Asked Question]] <br />
#[[Drupal_Gallery|Gallery]] <br />
#[[Drupal_Google_Calendar|Google Calendar]] <br />
#[[Drupal_MiddLab_Widget|MiddLab Widget]] <br />
#[[Drupal_News|News]] <br />
#[[Faculty_Profiles_in_Drupal|Profile]] <br />
#[[Drupal_Promotional_Calendar|Promotional Calendar]] <br />
#[[Drupal_Quick_Access|Quick Access]] <br />
#[[Drupal_Redirector|Redirector]] <br />
#[[Drupal_RSS_Page|RSS feed]] <br />
#[[Drupal_Slideshow|Slideshow]] <br />
#[[Drupal_Story|Story]] <br />
#[[Drupal_Subpage_List|Subpage list]] <br />
#[[Drupal_Webform|Webform]] <br />
<br />
= Managing Content =<br />
<br />
Once a content piece is created and saved, you can always go back and change it. You can edit the content, change the content permissions, adjust the scheduling, set what pages the content appears on, and reorder content on the page. '''Note: These tasks can also be done while initially creating the content.'''<br />
<br />
== Edit Content ==<br />
<br />
When a content piece is created, you can change anything that could also have been initially done during the creation of the content. To do this:<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content you wish to edit. <br />
#Scroll below the content piece you wish to edit and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Make the desired changes to your content. <br />
#When you are done editing the content, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
=== Links ===<br />
<br />
[[File:Drupal Editing Links.png|RTENOTITLE]]<br />
<br />
==== Creating a New Link ====<br />
<br />
#Highlight the text you wish to be the link. <br />
#Click the "Insert/edit link" button. It looks like a chain link. It is the button on the left in the image above. <br />
##The "Insert/edit link" console appears on your screen. <br />
#In the "Link URL" text field, put in the URL for the page you wish to link to. <br />
#Click the "Insert" button. <br />
##The "Insert/edit link" console disappears. <br />
#When you are done editing the content, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
==== Creating a Link Anchor ====<br />
<br />
#Highlight the text you wish to be the anchor target. <br />
#Click the "Insert/Edit Anchor" button. It looks like a boat anchor. It is the button on the right in the image above. <br />
#In the "Anchor Name" field type a single word to describe your anchor. Do not include the pound (#) symbol in the Anchor Name. <br />
#Click the Insert button. <br />
#Now highlight the text that you wish to be the link to the anchor. <br />
#Click the "Insert/edit link" button. It looks like a chain link. It is the button on the left in the image above. <br />
#In the "Link URL" field type the pound (#) symbol and then the word that you entered in step 3. <br />
#Click the Insert button. <br />
<br />
==== Removing a Link ====<br />
<br />
#Highlight all of the text in the link you wish to remove. <br />
#Click the "Unlink" button. It looks like a broken chain link. It is the button in the middle in the image above. <br />
<br />
==== Changing a Link ====<br />
<br />
Follow the directions in the "Creating a New Link" section above. The text you highlight initially will be the full text of the existing link.<br />
<br />
==== Having a Link Open in a New Window or Tab ====<br />
<br />
We '''strongly''' advise against setting a link to open in a new window or tab. This interrupts the user's experience. If they wish to get back to your site, most people prefer to use the Back button, which opening a link in a new window breaks. By default, links to sites outside of "www.middlebury.edu" will open in a new browser window or tab when someone clicks on them. If you would like to change this behavior for one of your links:<br />
<br />
#Highlight the text you wish to be the link. <br />
#Click the "Insert/edit link" button. It looks like a chain link. <br />
#Click the "Target" menu and select "Open in this window / frame". <br />
#Click Update. <br />
<br />
=== Images ===<br />
<br />
==== Uploading an Image ====<br />
<br />
In our site, images are normally uploaded to a hidden '''File Uploads''' page that holds all of the images for a section of the site.<br />
<br />
If the '''File Uploads''' page already exists...<br />
<br />
#Navigate to the '''File Uploads ''' page. <br />
#Click '''Add Content''' in the editing menu:<br/> [[File:MM-Add Content.png|none|300px|Add content screenshot]] <br />
#Choose '''File Upload''' in the content list:<br/> [[File:MM-File Upload.png|none|300px|File upload option screenshot.]] <br />
#Select your file and save the new content. <br />
<br />
If the '''File Uploads''' page doesn't exist...<br />
<br />
#Add a new Page to your section of the site and title it '''File Uploads''' <br />
#Under the '''Menu and Layout''' tab, choose '''Don't show this page in the menu'''<br/> [[File:MM-Hide from menu.png|none|300px|Hide from menu screenshot.]] <br />
#Save the new page. <br />
<br />
==== Inserting an image into content ====<br />
<br />
'''Note: These instructions apply to the "Basic Content" and "Story" content types.'''<br />
<br />
#Make sure you are logged on and in the editing interface for the content you wish to edit. <br />
#Click in your text in the area you wish to add an image. <br />
#Click the "Insert file upload" button. It's the 1<sup>st</sup> button in the 3<sup>rd</sup> row. <br />
##The "Insert file upload" console appears on your screen. <br />
#Use the links the find the files on the "File Uploads" page. <br />
#Click the image you wish to use. <br />
##A new window appears. <br />
#Use this screen to set the properties you want for the image. These cannot be changed later. <br />
#When you're done setting the properties, click the "Insert" button. <br />
##The window disappears. <br />
#To edit the image's settings, make sure it is selected and click the "Insert/edit image" button. It's the 2<sup>nd</sup> button in the 3<sup>rd</sup> row. <br />
##A new window appears. <br />
#Click the appearance tab. <br />
##You now see the image's appearance settings. <br />
#Edit the image as required. <br />
#When you're done editing the image settings, click the "Update" button. <br />
##The window disappears. <br />
#When you are done editing the content, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
&nbsp;<br />
<br />
=== Video ===<br />
<br />
'''Note: These instructions apply to the "Basic Content" and "Story" content types.'''<br />
<br />
Videos can be pulled from just about anywhere on the web, including YouTube and MiddTube. The syntax for inserting videos is:[video:URL width:value height:value align:value autoplay:value autorewind:value loop:value image:URL]. The video URL is the address of the site you found the video on. Accepted values for width and height are numbers. Accepted values for align are left and right. Accepted values for autoplay, autorewind and loop are 0 (false) and 1 (true). The image URL is used to change the "splash image" or the image show in the player when the video is not playing. Other than the video URL, all attributes are optional. To insert a video:<br />
<br />
#Make sure you are logged on and in the editing interface for the content you wish to edit. <br />
#Click in the text where you want to add a video. <br />
#Enter the line of code above, [video:URL width:value height:value align:value], inputting the desired URL and appropriate values. <br />
#When you are done adding the video, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
&nbsp;<br />
<br />
==== Panopto Videos ====<br />
<br />
#Log into Panopto and find the video in question. <br />
#Click the "Sharing" button for the video. <br />
#Copy the "Link" value for the video. <br />
#Put that link in a [[Drupal_Shortcodes|[video: ] shortcode]] in the Drupal text.<br/> Example:<br/> <code>[video:[https://midd.hosted.panopto.com/Panopto/Pages/Viewer.aspx?id=ee720a32-5f06-4ef4-b7df-aae20123e96a https://midd.hosted.panopto.com/Panopto/Pages/Viewer.aspx?id=ee720a32-5f06-4ef4-b7df-aae20123e96a]]</code> <br />
<br />
[[File:Panopto sharing example.png|600px|Panopto sharing example]]<br />
<br />
==== YouTube Playlists ====<br />
<br />
You can add a YouTube playlist by adding the playlist ID in the video URL. For example:<br />
<br />
[video:[http://www.youtube.com/watch?v=DaCP2kdYA4A&p=17B9CA1B31A33C5E http://www.youtube.com/watch?v=DaCP2kdYA4A&p=17B9CA1B31A33C5E]]<br />
<br />
or<br />
<br />
[video:[http://www.youtube.com/watch?v=DaCP2kdYA4A&list=17B9CA1B31A33C5E http://www.youtube.com/watch?v=DaCP2kdYA4A&list=17B9CA1B31A33C5E]]<br />
<br />
In these examples, the playlist ID follows the "p=" or "list=" parts of the URL.<br />
<br />
==== HTML5 Video ====<br />
<br />
Videos from MiddMedia will appear using the browser's built-in video player in the following browsers:<br />
<br />
#Safari <br />
#Mobile Safari for the iPad and iPhone <br />
<br />
Audio from MiddMedia will appear using the browser's built-in video player in the following browsers:<br />
<br />
#Safari <br />
#Mobile Safari for the iPad and iPhone <br />
#Chrome <br />
<br />
Other browsers will fallback to using the Adobe Flash version of the player. Videos from YouTube will play using a player from that site that detects the correct player type to use based on the browser and YouTube user preferences.<br />
<br />
==== Ustream Video ====<br />
<br />
To embed a Ustream video (or channel) use the following syntax: [video:URL] To obtain the correct URL, visit the Ustream channel, click on the Share button and select the Embed option <>. Highlight and copy the URL that has the word /embed/. Insert this link on your Drupal page using the following syntax: [video:[http://www.ustream.tv/embed/13154933 http://www.ustream.tv/embed/13154933]]<br />
<br />
=== Locations ===<br />
<br />
You can "geo-tag" your content to let people know that it is about a specific place. This is something you might want to do with a news story about student activity in an interesting location, or a program description of a course at a school abroad. This information can then be used to build a dynamic map of the different locations where your content appears. Send us an email if you're interested in creating this type of map. To add a location to your content:<br />
<br />
#When editing a piece of content, expand the Locations and then Location section at the bottom of the form. <br />
#Enter the address information for your locations. For most countries, this will automatically be translated into a Latitude and Longitude when you save the content. <br />
#Click Save. <br />
<br />
=== Meta Tags ===<br />
<br />
[[http://en.wikipedia.org/wiki/Meta_element Meta Tags]] can be used to supply additional information about your content to search engines and other programs accessing your content "behind-the-scenes". They are now shown on your page, but do appear in the HTML source of the page. The Meta Description is used by Facebook when you link to a page from that site. It is also often shown below the page link in search result pages in Google, Yahoo, and Bing.<br />
<br />
Because Meta Tags are added to nodes and we often show multiple nodes on each page, they will only work for individual nodes, like individual news stories. If you do not enter a Meta Description, one will be created for your content using the first few sentences from the content body.<br />
<br />
To edit the Meta Keywords or Meta Description:<br />
<br />
#Click the Edit link below the content. <br />
#Expand the Meta tags section near the bottom of the edit form. <br />
#Enter values for the keywords and/or description fields. <br />
#Click Save. <br />
<br />
=== Pasting from Word ===<br />
<br />
When copy/pasting from Microsoft Word, Word includes extra garbage markup that will be hidden in the editor, but show up in the output after the page is saved. Use the "Paste from Word" button on the editor toolbar to automatically strip out this extra markup when copy-pasting from Word.<br />
<br />
[[File:Drupal Paste From Word.png|500px|Drupal Paste From Word.png]]<br />
<br />
If you forget to use the "Paste from Word" toolbar button, use these steps to remove the extra markup:<br />
<br />
#Select all text in the visual editor <br />
#Use the toolbar button to copy the text <br />
#Use the "Paste from Word" button on the editor toolbar to automatically strip out the extra markup. <br />
#Save the content node to apply the changes. <br />
<br />
For even more drastic cleanup, highlight all text and use the "Remove Formatting" button to clear out all custom styles. You can then add formatting back in using the toolbar buttons.<br />
<br />
[[File:Drupal remove formatting.png|500px|Drupal remove formatting.png]]<br />
<br />
&nbsp;<br />
<br />
To manually clean up Word markup follow these steps: [[File:Drupal Cleanup Word Markup.png|500px|Drupal Cleanup Word Markup.png]]<br />
<br />
#Click the "HTML" button in the editor toolbar <br />
#Select the extra markup and delete it. <br />
#Click the "Update" button to save the changes back to the visual editor. <br />
#Save the content node to apply the changes. <br />
<br />
=== Tables ===<br />
<br />
To add and remove table columns from existing columns in the WYSIWYG editor, first click on a cell in the table and then look for these buttons in the editor:<br />
<br />
[[File:Drupal WYSIWYG Table Buttons.png|500px|Drupal WYSIWYG Table Buttons.png]]<br />
<br />
To change column widths and other properties, click in the table-cell you want to change, then use the '''Table Cell Properties''' button:<br />
<br />
[[File:Drupal Edit Table Cell Properties.png|500px|Edit table-cell properties including width.]]<br />
<br />
=== Embedding Interactive Elements ===<br />
<br />
For security reasons, users cannot insert Javascript code into the HTML of the site. To get around this limitation there are short-codes provided to allow embedding interactive widgets for select services, below.<br />
<br />
<br />
==== MailChimp ====<br />
<br />
You can embed a MailChimp campaign in a page with <code>[mailchimp URL]</code>. Example:<br />
<pre>[mailchimp //middlebury.us7.list-manage.com/generate-js/?u=050d2dfab1151df6a95fe1409&fid=06269&show=10]</pre><br />
<br />
{{note|Note: campaigns must be hosted at <code>middlebury.us3.list-manage.com</code> or <code>middlebury.us7.list-manage.com</code>.}}<br />
<br />
== Permissions ==<br />
<br />
=== Hierarchy ===<br />
<br />
Information on the content level permissions hierarchy can be found at [[Monster_Menus_Permissions|Monster Menus Permissions]].<br />
<br />
=== How to Change ===<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content who's permissions set you wish to change. <br />
#Scroll below the content piece you wish to alter permissions for and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Scroll down and click the "Who can edit or delete this content" link above the "Save" button. <br />
##The list of users with editing privileges appears. <br />
#There are 2 ways to add users to this permissions set. You can: <br />
#*Add individuals. <br />
#*#Use the text field to search for a user. As you type, matches will appear below. <br />
#*#Click on a person's name to add them to the list. <br />
#*Add groups. <br />
#*#Click the "Add" button. <br />
#*##A new window pops up. <br />
#*#Use the links to navigate to the group you wish to add. <br />
#*#Once you've found the group, click the "Select" link to the right of the group's name to add them to the list. <br />
#*##The extra window disappears. <br />
#When you are done setting the permissions set, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
== Appearance ==<br />
<br />
You have control over 2 appearance features for content. You can choose to make it sticky at the top of the page, and you can change its attribution style.<br />
<br />
=== Sticky ===<br />
<br />
Each time you add or edit a piece of content, it is placed at the top of the page, above any other existing content. By default, content is not sticky, but making content sticky at the top of the page forces it to remain above any other content. To control whether or not content is sticky:<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content who's stickiness you wish to change. <br />
#Scroll below the content piece you want to make sticky and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Scroll down and click the "Appearance" link. <br />
##You now see the content's appearance properties. <br />
#To make the content sticky, make sure the checkbox to make the content sticky at the top of the page is checked. <br />
#When you are done altering the stickiness, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
=== Attribution ===<br />
<br />
Each piece of content created stores information on who created it and when it was created. By default, content displays a message indicating the user that submitted the content. To change the attribution message:<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content who's attribution message you wish to change. <br />
#Scroll below the content piece you want to modify and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Scroll down and click the "Appearance" link. <br />
##You now see the content's appearance properties. <br />
#Use the "Attribution style" dropdown menu to change the attribution message. <br />
#When you are done altering the attribution message, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
== Scheduled Publishing ==<br />
<br />
Editing the Publish settings on a piece of content allows you to control when the content is published. This allows you to set a future start date for it to appear on your site, as well as a date for it to be automatically removed from your page. The Publishing setting is particularly effective for temporary content, or content that gets reused based on a schedule. To set publish dates:<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content you wish to schedule. <br />
#Scroll below the content piece you wish to schedule and click the "Edit" link. <br />
##You are now in the editing interface for this content piece. <br />
#Scroll down and click the "Publishing" link above the "Meta tags" label. <br />
##New text fields appear for setting publish dates and times. <br />
#Type the necessary dates and times into the "Publish on" and/or "Unpublish on" text fields. <br />
#When you are done setting publish dates for the content, scroll down and click the "Save" button. <br />
##The screen returns to "View" mode. <br />
<br />
&nbsp;<br />
<br />
== Pages ==<br />
<br />
If you have content you want to appear on multiple pages, you still only have to create it once. Once it is created, use the following instructions to make it appear on all other desired pages.<br />
<br />
#Make sure you are logged on. <br />
#Navigate to the page containing the content you wish to duplicate. <br />
#Go below the content piece and click the "Edit" link. <br />
##The screen now shows the editing interface for your content. <br />
#Scroll down if necessary and click the "Pages" link above the "Save" button.<br/> [[File:D7-node-pages-ui.png|center|500px|The Pages dialog on Drupal 7 nodes. A list of the pages that display this content appears, along with 3 new buttons.]]<br/> The Pages dialog on Drupal 7 nodes. A list of the pages that display this content appears, along with 3 new buttons. <br />
#You can: <br />
#*Add a page. <br />
#*#Click the "Add..." button. <br />
#*##A window appears with an index of the entire site. <br />
#*#Navigate to the page you wish to add the content to and click the "Select" link on the right hand side. <br />
#*##The window disappears and the new page is added to the list. <br />
#*Replace a page. <br />
#*#Click the name of the page you wish the content to no longer appear on. <br />
#*#Click the "Replace..." button. <br />
#*##A window appears with an index of the entire site. <br />
#*#Navigate to the page you wish to add the content to and click the "Select" link on the right hand side. <br />
#*##The window disappears and the new page is added to the list while the old one has been removed. <br />
#*Delete a page. <br />
#*#Click the name of the page you wish the content to no longer appear on. <br />
#*#Click the "Delete" button. <br />
#*##The name of the page is removed from the list. <br />
#When you are done managing the pages, click the "Save" button. <br />
##The screen returns to "View" mode.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Web Application Development]]<br />
[[Category:Drupal Academics]]<br />
[[Category:Public Search]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Troubleshooting&diff=42278Drupal Troubleshooting2022-12-21T20:34:55Z<p>Ian McBride: </p>
<hr />
<div>= Site Permissions =<br />
<br />
== "The user account is not available on this site" ==<br />
<br />
We're beginning the process of adding guest accounts to our systems. In doing this, we needed a way to differentiate the guest accounts (who should never be able to edit the site) from institutional accounts (who may be able to edit the site). A group has been set up to hold all of the institutional accounts in our system, but occasionally some valid institutional users slip through the cracks. If someone is getting this message, they are not in the institutional group. If it is a valid institutional account, this information should be forwarded to CSNS so that they can be added to the institutional group in the Active Directory.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Public Search]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Style_Guide&diff=42277Drupal Style Guide2022-12-21T20:34:43Z<p>Ian McBride: </p>
<hr />
<div>== Layout ==<br />
<br />
*The "juice bar" feature is a convenient place for sharing stories about your department or office, but remember that it takes up quite a bit of space at the top of your page. Laptop users, without scrolling, will see the main navigation, your banner and the juice bar, and that's about it. So, use the juice bar only if you have something important to say that can't be handled in any of the other content areas.<br />
*Check out and follow the advice from White Whale's Janie Porche on what kinds of content to use on different parts of the page using this [http://blogs.middlebury.edu/webredo/?attachment_id=541 Content Guide].<br />
<br />
== Text ==<br />
<br />
*When in doubt, check out the [http://www.middlebury.edu/offices/news/communications/styleguide Middlebury Editorial Style Guide] for usage questions: how to type a phone number, what to capitalize, etc.<br><br />
*Use as few typefaces as possible. For most of your text, use the regular paragraph style, and select just one or two display (headline) typefaces.<br />
*Avoid long banks of type when possible. If you must have a page with a lot of type, use lots of subheads.<br />
*Use display (headline) faces sparingly, and never for lengthy banks of type.<br />
*The "opening paragraph" style should only be on the home page of your site. And since it's designed to appear below a banner which includes the name of your department/office, you don't need to use a headline on top of this.<br />
*Use the "opening paragraph" text only for your opening paragraph. And that paragraph should be just three or four lines, and not more than eight.<br />
<br />
== Images ==<br />
<br />
*Don't use images as decoration. Images should be chosen to accomplish something specific.<br />
*Make sure images are of reasonable quality, and sized appropriately. (No huge head shots! No tiny panoramas!)<br />
*To display a large number of images, use the photo gallery content type.<br />
<br />
== Color ==<br />
<br />
*Pick a color palette you like, and then stick with it for your entire site.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Design]]<br />
[[Category:Style]]<br />
[[Category:Style Guides]]<br />
[[Category:Guides]]<br />
[[Category:Web Application Development]]<br />
[[Category:Public Search]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Story&diff=42276Drupal Story2022-12-21T20:34:27Z<p>Ian McBride: </p>
<hr />
<div>A "Story" is almost identical to a "Basic Content" in how it is created and how it appears. However, a "Story" is intended to be no more than a few sentences is length. It also has 2 additional features: a location and a link to more information.<br />
<br />
== Creating ==<br />
<br />
<ol><br />
<li>Make sure you are logged on.</li><br />
<li>Navigate to the page you wish to add content to.</li><br />
<li>Locate the "Edit Console" in the top left of the screen. Click the "Add" tab.</li><br />
<ol type="a"><br />
<li>The screen now lists all the content types.</li><br />
</ol><br />
<li>Click the "Story" link.</li><br />
<ol type="a"><br />
<li>The screen now shows the "Story" editing interface.</li><br />
</ol><br />
<li>In the "Title" text field, give your content a title.</li><br />
<li>In the "Body" text field, type your content.<br />
<li>Add the necessary links, images, and videos.</li><br />
<ul><br />
<li>Instructions on adding [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Links links], [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Images images], and [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Video video] can be found below.</li><br />
</ul><br />
<li>Adding a location is optional. If you wish to add a location, click the "Location" link below the "Body" text field.</li><br />
<ol type="a"><br />
<li>A new list of options appears. Filling in this information will cause it to appear with your story, as well as a link to a map of your location.</li><br />
</ol><br />
<li>In the "URL" text field, type in the address of a website with more information on this story.</li><br />
<li>If necessary, alter the appearance, set publish dates, and set permissions lists.</li><br />
<ul><br />
<li>Instructions on [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Appearance_2 appearance], [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Scheduling scheduling] and [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Permissions_2 permissions] can be found below.</li><br />
</ul><br />
<li>When you are done adding the content, scroll down and click the "Save" button.</li><br />
<ol type="a"><br />
<li>The screen returns to "View" mode.</li><br />
</ol><br />
</ol><br />
<br />
[[Category:Drupal]]<br />
[[Category:Drupal Content Types]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Slideshow&diff=42275Drupal Slideshow2022-12-21T20:34:13Z<p>Ian McBride: </p>
<hr />
<div>With the Slideshow content type you can add a set of images to a page that will automatically rotate or fade in and out. It is important to understand that '''all images you add to a Slideshow are fully public''', no matter what other page or content permissions you set in Drupal. '''Only use this feature for images that you want to be world-viewable'''.<br />
<br />
== Preparing your Images ==<br />
<br />
If you set a '''Width''' when creating your Slideshow, your images will be scaled to have that as their maximum width. Also, when the page is first loaded, only the first slide will load, with the other images loaded in the background to improve page load times. Even so, it is recommended that you prepare your images before creating your slideshow.<br />
<br />
# Determine where on your page(s) you want your Slideshow to appear.<br />
# Consult the [[Drupal_Region_Dimensions|Region Dimensions]] documentation to see what the width of that region is.<br />
# Use a program like Photoshop to crop your images so that they are the appropriate width and use the Save for Web feature to get a web-optimized copy of your image.<br />
<br />
Slideshows work best when your images are all the same proportions.<br />
<br />
== Creating the Slideshow ==<br />
<br />
# Navigate to the page where you want the Slideshow to appear and log in.<br />
# Click '''Add''' in the blue '''Content''' section of the Edit Console.<br />
# Click '''Slideshow''' in the list of available content types in the middle of the page.<br />
# Enter a '''Title''' for your Slideshow.<br />
# In the '''Images and Captions''' section:<br />
## Click '''Browse'''<br />
### Click '''Browse''' again in the pop-up that appears.<br />
### Find your image on your computer, select it, and click '''Open'''.<br />
### Click '''Next'''.<br />
### (''optional'') Add some '''Alt text'''. Alternative text is used by screen readers, search engines, and when the image cannot be loaded. By adding alt text you improve accessibility and search engine optimization.<br />
### (''optional'') Add some '''Title text'''. Title text is used in the tool tip when a user hovers their mouse over the image. Adding title text makes it easier to understand the context of an image and improves usability.<br />
### Click '''Save'''.<br />
## Enter a '''Caption''' for your image. Your caption may contain bold, italics, and hyperlinks. If you add hyperlinks to your caption, whichever one is the first one added will be used to wrap the image in the slideshow in the same link.<br />
## If you want to add another slide, click the '''Add another item''' button and repeat these steps.<br />
# If you check the '''Show Pager''' checkbox, a series of • characters will be displayed below the slides, allowing people to click through to each slide. This feature is incompatible with progressive loading of slide images and enabling it will increase the initial page load time as all slides will need to be loaded.<br />
# In the '''Width''' textfield, enter the maximum width of the slideshow, in pixels. If you leave this blank, we will use the width of the largest image attached to this slideshow. Consult the [[Drupal_Region_Dimensions|Region Dimensions]] documentation to see what the width of each page region is.<br />
# Choose the '''Effect''' to use when transitioning slides. The available effects are:<br />
## Horizontal Scroll<br />
## Fade In<br />
## Fade Out<br />
## None<br />
# Choose the '''Timeout''', which is the time, in milliseconds (1000 ms = 1 second) between slide transitions. For example, if you enter 8000 here, each slide will appear for eight seconds.<br />
# Choose the '''Speed''', which is the time, in milliseconds (1000 ms = 1 second) that will be consumed by the transition effect. For example, if you enter 500 here, the fade or scroll effect will last half a second when moving to the next slide.<br />
# Click the '''Save''' button.<br />
<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Site_Structure&diff=42274Drupal Site Structure2022-12-21T20:34:01Z<p>Ian McBride: </p>
<hr />
<div>== Outline ==<br />
<br />
Our [[Drupal]] instance runs on a single web server with the majority of the site content in a single [[Drupal]] database. Some sites have their own [[Drupal]] database when they have significant functionality differences from the main site or are sites for affiliated or external entities. <br />
<br />
The "sites" directory in [[Drupal]] controls what sites are available and what functionality is available to each site. The sub-directory "all" contains modules and templates available to all sites. These modules include those we consider necessary to run any [[Drupal]] site and include Monster Menus, the Content Creation Kit (CCK), Views, the fckeditor, and a custom version of the CAS module that we use to integrate single sign on. The "default" sub-directory contains additional modules that are used for the main site as well as templates for the main site and many sub-sites, like the Library and Academic Departments. Each additional site, like MIIS and NER has its own directory under "sites" and its own database.<br />
<br />
== Directory Structure ==<br />
<br />
*drupal <br />
**sites <br />
***all <br />
****modules <br />
*****monster_menus <br />
*****cck <br />
*****views <br />
*****fckeditor <br />
*****cas <br />
***default <br />
****modules <br />
****templates <br />
*****midd <br />
*****museum <br />
*****library <br />
*****department1 <br />
*****department2 <br />
***www.miis.edu <br />
****modules <br />
****templates <br />
*****miis <br />
***www.newenglandreview.org <br />
****modules <br />
*****ecommerce <br />
****templates <br />
*****ner<br />
<br />
== Advantages ==<br />
<br />
*The site becomes significantly simpler for us to support. Module upgrades only need to be done for code once, since there is only one server with one instance of the code. Furthermore, when modules are upgraded we only need to run the update script in [[Drupal]] for each subsite, of which there will be few. Patches and security fixes can be applied sooner and more efficiently, which will lead to better security and stability for the system.<br />
*There is a lower overhead for implementing backup and disaster recovery systems. One thought is that we could have a copy of the code and database running on a server at MIIS or in through a hosting company to be used as a failover. With one server and one code base, it is much easier to implement this plan. This also applies if we need to set up a load balanced cluster.<br />
*Developer interaction is not necessary to set up a new department or office site. If each department, office, and business unit had its own database and directory in the "sites" directory, a developer would need to set each one up, move the appropriate templates and modules into that sub-site and create the database. By having the majority of the content in a single database, we enable content creators to be able to create new sub-sites through Monster Menus in the web interface.<br />
*Content can be moved from one area of the site to another. [[Drupal]] stores content in nodes, each with its own id. If node 36 in site 1 needs to be moved to site 2, we need to check site 2 to make sure that it doesn't have its own node 36 and then resolve any conflicts. This is further complicated by Monster Menus, which assigns ids to page content that may, or may not, translate to node ids. Because of these complications, it is a significant undertaking to move content between sub-sites. However, by keeping this all in a single database, [[Drupal]] and Monster Menus allow content managers to move content within the IA through the web interface, without needing to contact the development team.<br />
<br />
== Disadvantages ==<br />
<br />
*We need to be more careful with which modules are installed. [[Drupal]] loads its installed modules into memory and having too many can cause performance problems. For this reason, if a module is requested that will only be used by a small portion of the site content, we need to do additional investigation to determine whether we can allow that module to be installed.<br />
<br />
== Frequently Asked Questions ==<br />
<br />
=== What happened to the separation of "the dotted line"? ===<br />
<br />
You may recall in early discussions during the Web Redo Project we explained that the core site would move to being many fewer pages and that departments and offices would have more freedom in how they structured and implemented their web content. There would then be a "dotted line" separating the two, through which content moved via aggregation, if desired. This is still the case.<br />
<br />
What is described here is an implementation decision for the platform that has a low impact on content creation or presentation. Even though all this content is in a single database it does not necessarily appear the same to those viewing it on the web, nor is it necessarily managed by the same group of people. The "dotted line" from those early discussions still exists in the form of content authorship, management, and presentation.<br />
<br />
=== Can departments and offices still have their own look-and-feel? ===<br />
<br />
Yes. In Monster Menus you can set which templates and content types are available to a part of the IA. Even though all the pages are in the same database, there is no requirement that a particular department's site look like the Public Affairs site.<br />
<br />
=== Can I manage permissions for my department or office site? ===<br />
<br />
Yes. Another feature of Monster Menus is delegated permissions management. Each department and office can work out on its own who will be updating their site and how it will be managed.<br />
<br />
== Module Evaluation ==<br />
<br />
Because we need to be cautious of which modules are installed for this instance of [[Drupal]], we are aware that the potential for conflict exists when you request a module for an area of the site you manage. Were your site in its own database, on its own web server, it would only be a matter of installing the functionality you request. But because we need to weigh your need for this functionality against the performance of the rest of the site for all users, we may not be able to complete the request. Here are the steps we take in making that determination.<br />
<br />
=== Step 1: Is this the right tool for the job? ===<br />
<br />
We begin by consulting with you on what you're trying to achieve. We want to make sure that the module you're requesting meets the requirements of the task. In some cases, there may be tools that are better geared toward your task that you hadn't considered or edge cases that the module you're requesting cannot handle gracefully. Oftentimes there are several [[Drupal]] modules that accomplish the same task, but do so in different ways.<br />
<br />
=== Step 2: Have you tried another tool? ===<br />
<br />
We run many different web applications at Middlebury. For each, we try to choose a "best of breed" tool that does one thing very well and run that, rather than have a "swiss army knife" application that does many things. For instance, if you requested a Wiki module for your site in [[Drupal]], we would want to find out whether MediaWiki would meet your requirements. Another advantage of everyone using the same tools is that we have an internal community of other users, Helpdesk staff, student tutors, and developers who can answer questions about that application.<br />
<br />
=== Step 3: Evaluate the shared need ===<br />
<br />
Many departments and offices are trying to solve the same problems you are and may benefit from the added functionality you're requested. For example, you might request a newsletter management module be installed for your site, which is likely something that other sites would also use. If what you're requesting will help many people, then potential performance issues are offset by the module's utility.<br />
<br />
=== Step 4: Evaluate the code ===<br />
<br />
We need to ensure that anything we install will allow the rest of the site to continue working. We evaluate all new modules to make sure there are no obvious security issues, that the module does not perform tasks that would overwhelm the server, and that the functionality it adds doesn't affect the operation of other modules we have installed. Additionally, modules may need to be modified by our team to work with the Monster Menus module.<br />
<br />
=== Step 5: Decide whether to add to the main site, or create a new sub-site ===<br />
<br />
If we cannot add the module to the main site, we can create a new sub-site to store your site content that will run the new module. If we create this new site, you will be responsible for migrating your current content into that sub-site. You will also be responsible for migrating your content back to the main site, if you choose to do so at a later date. We would typically consider this step only in the event where you requested a module that significantly changed the nature of your site. For example, a [[Drupal]] module that added a presentation layer to the library catalog, like Scriblio does for WordPress, would be implemented as new sub-site.<br />
<br />
=== Step 6: Install the module ===<br />
<br />
We make any necessary changes to the module so that it works with Monster Menus and then add it to the collection of modules for the main site.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Module]]<br />
[[Category:Web Application Development]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Shortcodes&diff=42273Drupal Shortcodes2022-12-21T20:33:45Z<p>Ian McBride: </p>
<hr />
<div>A "shortcode" is a snippet of text that allows you to insert special elements into your page. These can be placed in any WYSIWYG editor window.<br />
<br />
<br />
== Video ==<br />
<br />
The most common shortcode is used to embed video. To embed a video, get its URL from your video service of choice.<br />
<br />
For Panopto, use the "Link" in the sharing screen:<br />
<br />
[[File:Panopto sharing example.png|700px]]<br />
<br />
Example:<br/> <code>[video:<span class="external free">https://midd.hosted.panopto.com/Panopto/Pages/Viewer.aspx?id=ee720a32-5f06-4ef4-b7df-aae20123e96a</span>]</code><br/> &nbsp;<br />
<br />
For [[MiddMedia|MiddMedia]] use the "HTTP (Download) URL". Here is an example of using the video embed code with a video from [[MiddMedia|MiddMedia]] of the 2012 Convocation.<br />
<br />
<code>[video:[http://middmedia.middlebury.edu/media/Communications_LiveRecording-MIDD-web_data-middlebury-edu/mp4/2012Convocation.mp4 http://middmedia.middlebury.edu/media/Communications_LiveRecording-MIDD-web_data-middlebury-edu/mp4/2012Convocation.mp4]]</code><br />
<br />
=== Supported Video Sources ===<br />
<br />
We support video from the following sources.<br />
<br />
*[http://blip.tv/ Blip.tv] <br />
*[http://capped.tv/ Capped.tv] <br />
*[http://www.collegehumor.com/ College Humor] <br />
*[http://www.dailymotion.com/ DailyMotion] <br />
*[https://exposure.co/ Exposure] <br />
*[http://www.flickr.com/ Flickr Video] <br />
*[http://www.flickr.com/ Flickr Slideshows] <br />
*[http://www.gametrailers.com/ Gametrailers] <br />
*[http://gamevideos.1up.com/ Gamevideos] <br />
*[http://www.godtube.com/ Godtube] <br />
*[http://video.google.com/ Google Video] <br />
*[http://metacafe.com/ Metacafe] <br />
*[http://middmedia.middlebury.edu MiddMedia] <br />
*[http://www.myspace.com/ Myspace] <br />
*[https://midd.hosted.panopto.com/Panopto/Pages/Home.aspx Panopto] <br />
*[http://picasaweb.google.com/ Picasa] <br />
*[http://www.slideshare.net/ Slideshare] <br />
*[http://www.soudcloud.com/ SoundCloud] <br />
*[http://www.vimeo.com/ Vimeo] <br />
*[http://www.wistia.com/ Wistia] <br />
*[http://www.youtube.com/ YouTube] <br />
<br />
=== Video Player Attributes ===<br />
<br />
You can change the appearance or behavior of the video player using attributes added to the shortcode. Not all of these work on videos from every source listed above. They should all work for videos from MiddMedia. The "width", "height" and "ratio" attributes can be used with any video. All of these are '''optional'''.<br />
<br />
*'''Width''' written as <code>width:123</code> where "123" is the desired width of the player, in pixels. <br />
*'''Height''' written as <code>height:123</code> where "123" is the desired height of the player, in pixels. <br />
*'''Open''' written as <code>open:1</code> where "1" indicates that clicking on the video should open a pop-out player, rather than playing it inline. See the [http://www.miis.edu/ MIIS Spotlight feature] on that site's homepage for an example. <br />
*'''Image''' written as <code>image:[http://url_of_image.jpg http://url_of_image.jpg]</code> puts a "splash" image over the video player, allowing you to highlight a particular frame if you have a separate image of it. <br />
*'''Ratio''' written as <code>ratio:16/9</code> allows you to set the aspect ratio of the video player. The default value is 16/9. <br />
*'''Align''' written as <code>align:left</code> or <code>align:right</code> to align the video player to one side of the content. <br />
*'''Autoplay''' written as <code>autoplay:1</code> or <code>autoplay:0</code> where "1" indicates that the video should play automatically when the page loads ('''discouraged''') and "0" indicated that the video should only play when the user clicks the play button. The default is "0". <br />
*'''Autorewind''' written as <code>autorewind:1</code> or <code>autorewind:0</code> where "1" indicates that after the video is done playing, the play bar is moved back to the beginning and "0" indicates that it is left at the end. The default is "0". <br />
*'''Loop''' written as <code>loop:1</code> or <code>loop:0</code> where "1" indicates that the video should begin again after it is finished automatically and "0" indicates that it should not. The default value is "0". <br />
<br />
'''A note about ratio''': The default value of this attribute is 16/9. If you have a video that you want to play at a very precise pixel dimension, especially for large videos, or because you are using a specific splash image, you can set the ratio to the value of "width/height". Example: <code>width:589 height:374 ratio:589/374</code>.<br />
<br />
Here is an example of a video shortcode using all of these attributes:<br />
<br />
<code>[video:[http://middmedia.middlebury.edu/media/Communications_LiveRecording-MIDD-web_data-middlebury-edu/mp4/2012Convocation.mp4 http://middmedia.middlebury.edu/media/Communications_LiveRecording-MIDD-web_data-middlebury-edu/mp4/2012Convocation.mp4] width:640 height:480 open:1 image:[http://middmedia.middlebury.edu/media/Communications_LiveRecording-MIDD-web_data-middlebury-edu/splash/2012Convocation.jpg http://middmedia.middlebury.edu/media/Communications_LiveRecording-MIDD-web_data-middlebury-edu/splash/2012Convocation.jpg] ratio:16/9 align:left autoplay:0 autorewind:0 loop:0]</code><br />
<br />
=== Vimeo Attributes ===<br />
<br />
The Vimeo player supports a set of custom attributes.<br />
<br />
*'''Autoplay''' written as <code>autoplay:1</code> or <code>autoplay:0</code> where "1" indicates that the video should play automatically when the page loads ('''discouraged''') and "0" indicated that the video should only play when the user clicks the play button. The default is "0". <br />
*'''Loop''' written as <code>loop:1</code> or <code>loop:0</code> where "1" indicates that the video should begin again after it is finished automatically and "0" indicates that it should not. The default value is "0". <br />
*'''Color''' written as <code>color:ff9933</code> where the value is a hexadecimal representation of an RGB color value. If no value is included, 00adef will be used. <br />
*'''Title''' written as <code>title:0</code>. The only valid value is 0. If included, the title of the video will not be shown on the splash screen. <br />
*'''Byline''' written as <code>byline:0</code>. The only valid value is 0. If included, the byline of the video will not be shown on the splash screen. <br />
<br />
Here is an example:<br />
<br />
<code>[video:[https://vimeo.com/72660526 https://vimeo.com/72660526] width:456 height:256.5 color:ff9933 title:0 byline:0]</code><br />
<br />
=== YouTube Playlists ===<br />
<br />
You can add a YouTube playlist by adding the playlist ID in the video URL. For example:<br />
<br />
<code>[video:[http://www.youtube.com/watch?v=DaCP2kdYA4A&p=17B9CA1B31A33C5E http://www.youtube.com/watch?v=DaCP2kdYA4A&p=17B9CA1B31A33C5E]]</code><br />
<br />
or<br />
<br />
<code>[video:[http://www.youtube.com/watch?v=DaCP2kdYA4A&list=17B9CA1B31A33C5E http://www.youtube.com/watch?v=DaCP2kdYA4A&list=17B9CA1B31A33C5E]]</code><br />
<br />
In these examples, the playlist ID follows the "p=" or "list=" parts of the URL.<br />
<br />
=== Exposure Attributes ===<br />
<br />
In addition to height, width, and ratio, Exposure embeds also support two custom attributes: <code>title:</code> and <code>author:</code>. These attributes will set the attribution line below the embed content. Underscores will be translated to spaces. Example:<br />
<pre>[video:https://middlebury.exposure.co/middlebury-presidential-inauguration width:600 height:600 author:Middlebury title:Inauguration_of_Laurie_L._Patton]</pre><br />
<br />
== Audio ==<br />
<br />
Audio uses the same shortcode as video, which might be confusing, but will work. The only supported sources for audio files are [[MiddMedia]] and [[Panopto]]. Here is an example of the shortcode to use for an audio file.<br />
<br />
<code>[video:http://middmedia.middlebury.edu/media/imcbride/mp3/Tree_Miller.mp3]</code><br />
<br />
<code>[video:https://midd.hosted.panopto.com/Panopto/Pages/Viewer.aspx?id=##########]</code><br />
<br />
Unlike video, you cannot set the height, width or other attributes of the audio player.<br />
<br />
== Computer Labs ==<br />
<br />
You might want to add information about the labs that visitors to your site use. We can display the number of available machines in each of these labs to give people real-time information about their usage. To do this use the labserver shortcode.<br />
<br />
<code>[labserver]</code> will print the total number of available machines in all computer labs.<br />
<br />
<code>[labserver 3]</code> will print the total number of available machines in computer lab 3, which is Armstrong 161.<br />
<br />
<code>[labserver 65,43]</code> will print the total number of available machines in computer labs 65 (LIB 105) and computer lab 43 (LIB 140) combined.<br />
<br />
You can get the ID of the lab to use by clicking on any of the labs on the [http://labserver.middlebury.edu:8080/public/current_stats.jsp LabStats] site and looking at the URL, which will include a "lab_id" parameter.<br />
<br />
== Alumni Profiles ==<br />
<br />
To display a list of all Alumni Profiles:<br />
<br />
<code>[view:alumni_profiles]</code><br />
<br />
To display a list of Alumni Profiles from a single department, include that department's four letter Banner subject code:<br />
<br />
<code>[view:alumni_profiles=default=ITAL]</code><br />
<br />
To display a list of Alumni Profiles from multiple departments, include a + separated list of those departments' four letter Banner subject codes:<br />
<br />
<code>[view:alumni_profiles=default=ITAL+GEOL]</code><br />
<br />
To display a slider of random Alumni Profiles:<br />
<br />
<code>[view:alumni_profile_slider]</code><br />
<br />
To display a slider of Alumni Profiles from a single department, include that department's four letter Banner subject code:<br />
<br />
<code>[view:alumni_profile_slider=default=ITAL]</code><br />
<br />
To display a sliderof Alumni Profiles from multiple departments, include a + separated list of those departments' four letter Banner subject codes:<br />
<br />
<code>[view:alumni_profile_slider=default=ITAL+GEOL]</code><br />
<br />
== List Manager Subscription Forms ==<br />
<br />
You can embed a sign-up form for your List Manager mailing list in content using this shortcode, where the second part is the name of your mailing list. For example:<br />
<br />
<code>[listmanager middnews_general]</code><br />
<br />
You can have a nice printed description for the list, rather than showing the machine name of the list to the user. To do this, add the description of the list separated from its name by a colon.<br />
<br />
<code>[listmanager middnews_general:MiddNews]</code><br />
<br />
You can allow the user to subscribe to multiple lists at once using the same form. To do this, separate this lists with commas.<br />
<br />
<code>[listmanager middnews_general:MiddNews,artsmail:Arts at Middlebury]</code><br />
<br />
== Storify ==<br />
<br />
[http://storify.com Storify] is a service that allows you to build a story using clips from many social networks. Search for a term like "Middlebury Reunion" and find the Facebook posts, Tweets, YouTube videos, Instagrams, etc. about that event and then drag-and-drop them into a list that can be displayed on your site.<br />
<br />
To use this add the following shortcode to your content:<br />
<br />
<code>[storify:STORY_URL]</code><br />
<br />
<br />
<br />
<br />
<br />
== iframe Embeds ==<br />
<br />
We allow iframe embeds from several sites, when we need to support embedded forms or other interactive elements. These are whitelisted by domain. The current list of supported domains is:<br />
<br />
*app.e2ma.net <br />
*e.issuu.com <br />
*middlebury-sciences.libcal.com <br />
*learn.middlebury.edu <br />
*middlebury.tfaforms.net <br />
*share.transistor.fm <br />
*www.sensusaccess.com <br />
*view-awesome-table.com <br />
<br />
These can be embedded using the following code:<br />
<br />
<code>[iframe [https://middlebury.tfaforms.net/217719 https://middlebury.tfaforms.net/217719]]</code><br />
<br />
We support the following attributes, all of which are optional:<br />
<br />
*'''width''' written as <code>width:123</code> where "123" is the desired width of the iframe, in pixels. <br />
*'''height''' written as <code>height:123</code> where "123" is the desired height of the iframe, in pixels. <br />
*'''allowfullscreen''' written as <code>allowfullscreen:true</code> to allow a fullscreen button on the iframe. Can be either "true" or "false". <br />
*'''allowTransparency''' written as <code>allowTransparency:true</code> to allow transparent iframes. Can be either "true" or "false". <br />
*'''frameborder''' written as <code>frameborder:0</code> to show a border on the frame. Can be either "0" or "1". <br />
*'''scrolling''' written as <code>scrolling:yes</code> to show a scrollbar on the iframe if the content exceeds the specified width and height dimensions. Can be either "yes" or "no".<br />
<br />
== Theta360 ==<br />
<br />
Panoramic images from this service can be embedded in the site using the following shortcode:<br />
<br />
<code>[theta image=https://theta360.com/s/cOq9vWMcV9jNvi0syU1MaAVM0 width=500 height=375]</code><br />
<br />
The "image" attribute is required and must have the hostname "theta360.com". The width and height attributes are optional and will default to 500 and 375, respectively, if not included.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Drupal Academics]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Server&diff=42272Drupal Server2022-12-21T20:33:33Z<p>Ian McBride: </p>
<hr />
<div><br />
<br />
[[Category:Drupal]]<br />
[[Category:Web Application Development]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_RSS_Page&diff=42271Drupal RSS Page2022-12-21T20:24:24Z<p>Ian McBride: </p>
<hr />
<div>The "RSS feed" type can be used to dynamically pull headlines from other places. You can pull RSS feeds from anywhere on the web, page feeds from within the Middlebury site, or tag feeds from within the Middlebury site.<br />
<br />
== Creating ==<br />
<br />
<ol><br />
<li>Make sure you are logged on.</li><br />
<li>Navigate to the page you wish to add content to.</li><br />
<li>Locate the "Edit Console" in the top left of the screen. Click the "Add" tab.</li><br />
<ol type="a"><br />
<li>The screen now lists all the content types.</li><br />
</ol><br />
<li>Click the "RSS feed" link.</li><br />
<ol type="a"><br />
<li>The screen now shows the "RSS feed" editing interface.</li><br />
</ol><br />
<li>In the "Title" text field, give your content a title. The title should:<br />
<ul><br />
<li>Accurately convey what type of information is being pulled by this feed.</li><br />
</ul><br />
<li>Click the button of the type of feed you wish to add</li><br />
<li>Choose the source of your feed.</li><br />
<li>Repeat the previous 2 steps for any other feeds you wish to add to this content block on your page.</li><br />
<ul><br />
<li>If you have multiple feeds, you can reorder them with the icons below their titles.</li><br />
</ul><br />
<li>In the "Feed display options" box, you can:</li><br />
<ul><br />
<li>Use the dropdown menu to choose how many headlines to display at once.</li><br />
<li>Use the checkboxes to control the appearance of the feed.</li><br />
<li>Use the radio buttons to control how the feeds are sorted.</li><br />
</ul><br />
<li>If necessary, alter the appearance, set publish dates, and set permissions lists.</li><br />
<ul><br />
<li>Instructions on [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Appearance_2 appearance], [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Scheduling scheduling] and [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Permissions_2 permissions] can be found below.</li><br />
</ul><br />
<li>When you are done adding the content, scroll down and click the "Save" button.</li><br />
<ol type="a"><br />
<li>The screen returns to "View" mode.</li><br />
</ol><br />
</ol><br />
<br />
[[Category:Drupal]]<br />
[[Category:Drupal Content Types]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Region_Dimensions&diff=42270Drupal Region Dimensions2022-12-21T20:24:09Z<p>Ian McBride: </p>
<hr />
<div>= Page Regions =<br />
<br />
== www.middlebury.edu ==<br />
<br />
<table><br />
<tr><br />
<th>Theme</th><br />
<th>Example</th><br />
<th>Dimensions</th><br />
<th>Image</th><br />
</tr><br />
<tr><br />
<td>Full Width</td><br />
<td>[http://www.middlebury.edu/offices Offices & Services]</td><br />
<td>924px wide with 18px of forced padding on each side.</td><br />
<td>[[File:Drupal Dimensions Fullwidth.png|thumbnail]]</td><br />
</tr><br />
<tr><br />
<td>Content on a Page with no Sidebar</td><br />
<td>[http://www.middlebury.edu/events Calendar of Events]</td><br />
<td>684px wide with 18px of forced padding on each side.</td><br />
<td>[[File:Drupal_Dimensions_Content.png|thumbnail]]</td><br />
</tr><br />
<tr><br />
<td>Content on a Page with a Sidebar</td><br />
<td>[http://www.middlebury.edu/newsroom Newsroom]</td><br />
<td>462px with 18px of forced padding on each side.</td><br />
<td>[[File:Drupal_Dimensions_Content_Sidebar.png|thumbnail]]</td><br />
</tr><br />
<tr><br />
<td>Right Sidebar</td><br />
<td>[http://www.middlebury.edu/newsroom Newsroom]</td><br />
<td>180px wide with 11px of forced padding and 1px of border on each side.</td><br />
<td>[[File:Drupal_Dimensions_Right_Sidebar.png|thumbnail]]</td><br />
</tr><br />
<tr><br />
<td>Left Sidebar</td><br />
<td>[http://www.middlebury.edu/events Calendar of Events]</td><br />
<td>204px wide with 18px of forced padding on each side.</td><br />
<td>[[File:Drupal_Dimensions_Left.png|thumbnail]]</td><br />
</tr><br />
<tr><br />
<td>Address</td><br />
<td>[http://www.middlebury.edu/giving Giving]</td><br />
<td>204px wide with 18px of forced padding on each side.</td><br />
<td>[[File:Drupal_Dimensions_Address.png|thumbnail]]</td><br />
</tr><br />
<tr><br />
<td>Carousel Images</td><br />
<td>[http://www.middlebury.edu/offices/business/facilities Facilities Services Office]</td><br />
<td>240px high with no padding. Applies only to [[Drupal_File_Upload|File Upload]] nodes placed directly on the carousel page.</td><br />
<td>[[File:Drupal_Dimensions_Carousel_Image.png|thumbnail]]</td><br />
</tr><br />
<tr><br />
<td>Carousel</td><br />
<td>[http://www.middlebury.edu/admissions Admissions]</td><br />
<td>180px high with 30px of forced padding on each side.</td><br />
<td>[[File:Drupal_Dimensions_Carousel.png|thumbnail]]</td><br />
</tr><br />
</table><br />
<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Redirector&diff=42269Drupal Redirector2022-12-21T20:23:55Z<p>Ian McBride: </p>
<hr />
<div>The Drupal Redirector content type can be used to automatically redirect requests from one [[Editing_in_Drupal|Drupal]] page to any other web page address. This is useful for adding a page to your site navigation that sends people to an external website, for example the [http://go.middlebury.edu/give Giving Form] or if you have moved a single page to a new location.<br />
<br />
On www.middlebury.edu and www.miis.edu any person who goes to a page with a Redirector who does not have permission to edit it will be automatically sent to the new page. On forms.middlebury.edu and forms.miis.edu any person who goes to a page with a Redirector who is not logged in will be automatically sent to the new page, but people who are logged in will stay on the forms sites.<br />
<br />
== Creating a Page for the Drupal Redirector ==<br />
<br />
The most common use of Drupal Redirectors is to add links to the left navigation menu to pages that aren't part of your office or department site. To do this, you should first create a new '''Sub-page''', otherwise skip to the next section.<br />
<br />
# Browse to the page where you would like the link to appear in the left menu and log in.<br />
# In the orange '''Sub-pages''' section of the Edit Console, click '''Add Sub-page'''.<br />
# In the '''Title''' field, enter the text as you would like it to appear in the menu.<br />
# Click '''Create sub-page'''.<br />
<br />
== Creating a Drupal Redirector ==<br />
<br />
Creating a new Drupal Redirector works like creating any other type of content in our Drupal sites.<br />
<br />
# Browse to the page where you want to add this item and log in.<br />
# In the blue '''Content''' section of the Edit Console ribbon, click '''Add'''.<br />
# Select '''Redirector''' from the list of content types in the center of the page.<br />
# In the '''Location to redirect to''' there are two options.<br />
#*If you want to redirect someone to a page ''on the same Drupal site'', click on the '''Choose''' button. Doing this will store the internal ID of the destination page, rather than the URL, so your redirector will continue working if the destination page is moved or renamed.<br />
#**Find the destination page in the pop-out Tree Browser and click on its name in the left pane.<br />
#**Click '''Select''' in the right pane.<br />
#*If you want to redirect someone to a page on an external website, paste or write the URL of the page in the '''Destination URL''' textbox.<br />
# Click the '''Save''' button.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Drupal Content Types]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Publications&diff=42268Drupal Publications2022-12-21T20:23:41Z<p>Ian McBride: </p>
<hr />
<div>__FORCETOC__<br />
<br />
We have added Drupal's [http://drupal.org/project/biblio Bibliography Module] to the main website. This allows you to enter structured information about your publications, which you can then have appear on your Profile. The information will also appear in a central, searchable [http://www.middlebury.edu/biblio database of publications] and may be displayed on other sites, like [http://blogs.middlebury.edu/middlab MiddLab].<br />
<br />
== Adding a Publication ==<br />
<br />
# First, find your profile on our website and click the Edit link at the bottom of the profile. If you do not have access to edit your profile, you should contact the person to maintains your department site to have them grant you access. After you turn on displaying publications, you won't have to edit your profile again.<br />
# You'll see a new section under Dynamic Features, which will look like this:<br>[[File:Drupal_Publications_01.png]]<br />
# Click the link to start adding publication information. This will open a new browser window or tab to a page that is currently empty if you have not yet added any publications.<br />
# Click the Add link in the Edit Console at the top left of the screen.<br />
# Select "Biblio". This should be the only option.<br />
# You'll now see a form where you can enter bibliographic information about your publication, which should look like this:<br>[[File:Drupal_Publications_02.png]]<br />
# If your publication is in the [http://www.ncbi.nlm.nih.gov/pubmed/ PubMed] database, you can look it up to import the bibliographic information automatically. You can also do this with a [http://www.doi.org/ DOI] number, or paste in a [http://www.bibtex.org/ BibTex] or [http://en.wikipedia.org/wiki/RIS_(file_format) RIS] record. If you do not have this information, select the Publication Type from the provided drop-down menu. This will allow you to enter the relevant information for that type of publication.<br />
# Click the Save button to create your publication record.<br />
<br />
Your publication will look like this:<br>[[File:Drupal_Publications_03.png]]<br />
<br />
== Adding Publications to your Profile ==<br />
<br />
After you have created your first publication record, your name will be included as an author in our database. You can now use that information to display the records of your publications as part of your Profile on the Middlebury site.<br />
<br />
# Edit your Profile again, or switch back to the tab you were using where you were previously editing your profile.<br />
# In the "My publications" section, click the "Show my publications on my profile page".<br />
# Select your name from the "Link My Profile with this Author from the Biblio database" drop-down, which should look like this:<br>[[File:Drupal_Publications_04.png]]<br />
# The default citation style is MLA. If you would like your publications to appear with a different citation style, you may select it from the "Style" drop-down.<br />
# Save your profile. Your publications will now appear on your profile page like this:<br>[[File:Drupal_Publications_05.png]]<br />
<br />
You no longer need to edit your profile to add new publication information. Simply add that content to your My Publications page, which you will always have access to edit, and it will automatically appear on your profile. You can get back to your My Publications page at any time by going to http://www.middlebury.edu/middlebury_site/USERNAME where USERNAME is the first part of your email address, before the '@' symbol.<br />
<br />
== Copying your Profile to your Page ==<br />
<br />
You can copy your profile to your page which will allow you to always have access to edit its content. You can also use this as a place to link people who you'd like to view your profile.<br />
<br />
# Edit your Profile again.<br />
# Near the bottom of the editing form is a section labelled Pages. Click this to expand it.<br />
# Click the Add button<br />
# At the bottom of the list on the left is an item named "User list (hidden)" click the + to the left of this folder to open it.<br />
# Click the + next to the first letter in your '''first''' name.<br />
# Find your name in the list and click on it.<br />
# Click the Select link in the right column.<br />
# Click the Save button.<br />
<br />
[[Category:Web Application Development]]<br />
[[Category:Drupal]]<br />
[[Category:Drupal Academics]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Promotional_Calendar&diff=42267Drupal Promotional Calendar2022-12-21T20:23:27Z<p>Ian McBride: </p>
<hr />
<div>You can now add dynamic events calendars to your sites. To do this, use the new Promotional Calendar content type in Drupal. Calendars can be added to the center, left or right sidebars.<br />
<br />
Before you add a calendar, you will need to contact the Department of Event Management, x. 5362. Each department will receive a webName after the content and format of the calendar are determined. See below for instructions on how to add the calendar to your site AFTER you have received confirmation that a calendar has been created. (You will receive a calendar webName at that time).<br />
<br />
<ol><br />
<li>Go to the page or sidebar where you'd like to add the Calendar</li><br />
<li>Click Add in the Edit Console</li><br />
<li>Select Promotional Calendar from the list of content types</li><br />
<li>Enter your department's webName in the webName field </li><br />
<li>Enter the type of Calendar in the spudType field (see below)</li><br />
<li>Press the save button</li><br />
</ol><br />
<br />
== Calendar Types ==<br />
<br />
<b>spudType: main</b><br />
A large list of events like you see on the [[http://www.middlebury.edu/events/calendar_of_events/ Campus Events]] page. Should only be used in the center of a page.<br />
<br />
<b>spudType: upcoming</b><br />
A list of events like you see on the [[http://www.middlebury.edu/offices/technology/lis/ LIS home page]]. Can be used in the center or a sidebar.<br />
<br />
<b>spudType: datefinder</b><br />
A monthly grid calendar. Can be used in the sidebar with a main calendar in the center.<br />
<br />
<b>spudType: chooser</b><br />
Put this in the sidebar to let people change the way they see a "main" calendar in the center of the page.<br />
<br />
[[Category:Drupal Content Types]]<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_MiddLab_Widget&diff=42266Drupal MiddLab Widget2022-12-21T20:23:15Z<p>Ian McBride: </p>
<hr />
<div>Departments and Offices can add a MiddLab promotional item to their sidebar to show projects that relate to their area. An example of this in action can be seen on the [http://www.middlebury.edu/academics/resources/uro Undergraduate Research] site. To add this:<br />
<br />
<ol><br />
<li>Click [Edit] above your site's sidebar.</li><br />
<li>Click Add in the Edit Console.</li><br />
<li>Select MiddLab Widget from the list in the center column.</li><br />
<li>Enter a Title.</li><br />
<li>Check the theme(s), department(s), and office(s) that are of interest.</li><br />
<li>Click Save.</li><br />
</ol><br />
<br />
[[Category:Drupal]]<br />
[[Category:Drupal Content Types]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Meta_Tags&diff=42265Drupal Meta Tags2022-12-21T20:22:38Z<p>Ian McBride: </p>
<hr />
<div>[http://en.wikipedia.org/wiki/Meta_element Meta Tags] can be used to supply additional information about your content to search engines and other programs accessing your content "behind-the-scenes". They are now shown on your page, but do appear in the HTML source of the page. The Meta Description is used by Facebook when you link to a page from that site. It is also often shown below the page link in search result pages in Google, Yahoo, and Bing.<br />
<br />
After you have changed the tags on a page or piece of content, you can verify that those tags are working using the [https://developers.facebook.com/tools/debug/ Facebook Debugger], which will give you information about all of the Open Graph and other custom meta tags it finds.<br />
<br />
'''Available tags''': see the [https://groups.drupal.org/node/229413 list of Officially supported meta tags for Nodewords & Metatags].<br />
<br />
== Adding Tags to Pages ==<br />
<br />
* Log in to Drupal<br />
* Click on '''Settings''' in the green '''Pages''' section of the [[Editing_in_Drupal#Edit_Console|Edit Console]].<br />
* Click on the '''Meta tags''' tab.<br />
* Enter the value(s) of the tags you wish to change on the page.<br />
* Click the '''Save settings''' button.<br />
<br />
== Adding Tags to Content ==<br />
<br />
* Log in to Drupal<br />
* Click the '''Edit''' link below the content.<br />
* Click on the '''Meta tags''' tabe.<br />
* Enter the value(s) of the tags you wish to change on the page.<br />
* Click the '''Save''' button.<br />
<br />
Tags added to content will only appear when you browse directly to that piece of content, which will be indicated by the text '''node/######''' in the URL shown in your browser's address bar.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Social Media]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Instagram&diff=42264Drupal Instagram2022-12-21T20:22:24Z<p>Ian McBride: </p>
<hr />
<div>Due to a change in the [http://developers.instagram.com/post/133424514006/instagram-platform-update terms of service for the Instagram API], this feature is no longer available.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Social Media]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Gallery&diff=42263Drupal Gallery2022-12-21T20:22:11Z<p>Ian McBride: </p>
<hr />
<div>The Gallery content type can be used to show a series of images. There are many ways to configure this feature. This documentation will cover what we consider the simplest and most common configuration.<br />
<br />
== Create a New File Uploads Page ==<br />
<br />
It is best to create a new File Uploads page, with a name that identifies it as being used by your gallery, to hold all the images for your Gallery. This makes selecting and ordering the images significantly easier. You can create this as a child page of your existing File Uploads page, if you have one.<br />
<br />
See [[Drupal File Upload#Create a File Uploads Page|the steps to create a new File Uploads page]].<br />
<br />
=== Add the Images ===<br />
<br />
See [[Drupal File Upload#Creating File Uploads]] for the steps to upload the images to your new File Uploads page.<br />
<br />
== Create the Gallery ==<br />
<br />
On the page where you want the Gallery to appear:<br />
<br />
# Click '''Add''' in the blue '''Content''' section of the Edit Console.<br />
# Select '''Gallery''' from the list of content types.<br />
# Add a '''Title''' to the Gallery.<br />
# Click '''Add''' in the '''Images''' section.<br />
## Browse to your new File Uploads page in the tree browser in the left pane of the window that opened and click on it.<br />
## Click '''Select all''' in the right pane.<br />
# Select your appearance options as desired. For the thumbnail size:<br />
#* The width of the content on a page with a sidebar is 450px (standard)<br />
#* The width of the content on a page without a sidebar is 680px (large)<br />
# Click save.<br />
<br />
== Embedding Galleries in other Content ==<br />
<br />
You can use the following shortcode to embed a Gallery in other content, such as a News article.<br />
<br />
<code>[view:embed_content==######]</code><br />
<br />
Where the '''######''' is the node ID of the Gallery. This is the part of the URL for the Gallery that looks like "node/######".<br />
<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_File_Upload&diff=42262Drupal File Upload2022-12-21T20:21:59Z<p>Ian McBride: </p>
<hr />
<div>'''File Upload''' is a special [[Editing_in_Drupal#Content_Types|Content Type]] in our instance of Drupal that allows you to store information associated with a file. Currently, we allow you to upload most image and document file types. You can place these '''File Uploads''' directly on a page, as you would a news story or profile, or you can add them to a hidden page and then embed the file inside another piece of content.<br />
<br />
== Create a File Uploads Page ==<br />
<br />
Most of the time you will want to first upload your files to a hidden page on your portion of the site that can be used to organize and store the files before you embed them in your content. We have established a convention of titling these pages '''File Uploads''' and hiding them from the menu. Note that even though they are hidden from the menu they are still publicly accessible, as are their contents. See the [[Drupal_File_Upload#Permissions|Permissions]] section below for information on how to restrict access.<br />
<br />
Most areas of the site will already have a '''File Uploads''' page, but if yours does not, you can add one using these steps:<br />
<br />
# Browse to your portion of the site and log on.<br />
# Click on '''Add Sub-page''' in the orange '''Sub-pages''' section of the Edit Console.<br />
# Enter '''File Uploads''', or whatever you'd like to call the page, in the '''Page name''' field.<br />
# Click on the '''Menu and layout''' tab and check '''Don't show this page in the menu'''.<br />
# Click the '''Create Sub-page''' button at the bottom of the form.<br />
<br />
You can also create sub-pages of your file uploads page to better organize your files. You might want to create a new sub-page for each month, or for various programs within your area.<br />
<br />
== Permissions ==<br />
<br />
The '''File Upload''' inherits the permissions of the page on which it is placed. Even if it is placed on a "(hidden)" page, those are only hidden from the menu. They are still publicly readable, as are their contents, if someone knows the address. If you have a sensitive file that should not be publicly visible, first consider whether Drupal is the best place for that file. It may make more sense to host it on [[MiddFiles]] or [[Google_Apps|Google Docs]].<br />
<br />
If you decide that you need to upload a document to Drupal which should not be public, you will need to create a new page with the appropriate permissions. To do that:<br />
<br />
# Create a new sub-page. Name this something like "Midd Only File Uploads" and hide it from the menu.<br />
## Browse to an existing '''File Uploads (hidden)''' page on your site.<br />
## Click on '''Add Sub-page''' in the orange '''Sub-pages''' section of the Edit Console.<br />
## Enter '''Midd Only File Uploads''', or whatever you'd like to call the page, in the '''Page name''' field.<br />
## Click on the '''Menu and layout''' tab and check '''Don't show this page in the menu'''.<br />
# In the '''Permissions''' section of the page settings, make sure that the '''Read''' checkbox to the right of '''Everyone''' is unchecked.<br />
# Add the '''institution''' group to the Group permissions and give it only '''Read''' access. The '''institution''' group can be found within '''Groups''' and then '''General''' in the group menu. This group contains everyone at Middlebury, MIIS, the Language Schools, Schools Abroad, etc. You may wish to use a different group if you only want this visible to faculty, staff, and/or students, but '''institution''' is the go-to group for all Middlebury-related people.<br />
# Upload your documents to this new page and described below.<br />
# Click the '''Create Sub-page''' button at the bottom of the form.<br />
<br />
== Creating File Uploads ==<br />
<br />
Once you have your page(s) all set up, you're ready to upload the files to the site. To do this:<br />
<br />
# Navigate to your '''File Uploads (hidden)''' page.<br />
# Click '''Add''' in the blue '''Contents''' section of the Edit Console.<br />
# Select '''File Upload''' from the list of content types in the middle of the page.<br />
# Click the '''Browse''' button in the '''Files to upload''' section.<br />
# Select the files to upload from your desktop or mapped drive.<br />
# Click the '''Upload''' button.<br />
# Give each image or document a '''Title'''. This will be displayed above the image, if your file is an image, or used as the link text, if your file is a document. By default, the title will be the file name.<br />
# (''optional'') Add '''Caption''' text. This will be displayed below the image or document when the full '''File Upload''' node is displayed, though not (currently) when it is embedded in other content.<br />
# (''optional'') Add a '''URL''' if you would like to wrap the image in a link to a different page. This only works if your file is an image. It will be ignored for documents.<br />
# If you added a '''URL''', you can choose how that link will work in the '''Target''' drop down.<br />
# Click '''Save''' to create the '''File Upload'''(s).<br />
<br />
== Embedding in Other Content ==<br />
<br />
Now that you've uploaded your file to Drupal, you can add it to other content by embedding it using the WYSIWYG editor.<br />
<br />
# Edit or create a piece of content, other than a File Upload.<br />
# Place your cursor in the editor window where you would like the file to appear.<br />
# Click the '''Select a file upload''' button. This looks like overlapping photos of mountains. It is the leftmost button in the third row of the editor.<br />
## Browse to your '''File Uploads (hidden)''' page in the tree browser in the left pane of the window that opened and click on it.<br />
## Click on the image or document you want to use in the list on the right.<br />
## (''optional'') Add a '''Title'''. Title text is used in the tool tip when a user hovers their mouse over the image. Adding title text makes it easier to understand the context of an image and improves usability.<br />
## (''optional'') Add some '''Alternate text'''. Alternative text is used by screen readers, search engines, and when the image cannot be loaded. By adding alt text you improve accessibility and search engine optimization.<br />
## Select the image style you want to use from the '''Style''' dropdown. It is suggested that you use the next-highest value from the size of the image you want to display, as this will improve page load time. For example, if you have a image that is 1280x1024 pixels, but want to display it in your content at 300px wide, choose "Standard (450x450)" from the style dropdown. This will create a smaller copy of the image at the appropriate dimensions so that it will load faster. See the [[Drupal_Region_Dimensions|Region Dimensions]] documentation for information on how wide each section of the page is.<br />
## Check the '''Clicking on this image shows it full-size''' checkbox to wrap the image in a link that will show the full image in a pop-out dialog. If you later decide to add a link around the image to a different location, the pop-out dialog will not be shown.<br />
## Click the '''Insert''' button.<br />
# Save your piece of content.<br />
<br />
== Replacing a File Upload ==<br />
<br />
To replace a file,<br />
<br />
# Locate the file that you want to replace in the File Upload's area of your site.<br />
# Click the Edit link for the File Upload item.<br />
# In the Edit form, find the Upload field and click the Edit button.<br />
# Click the Replace button, and browse your computer to find the new file.<br />
# Save your changes<br />
<br />
All links to that file upload (if you've linked to it with the "Select a File Upload" button - see above) will be updated to link to the new file that you've replaced at the source.<br />
<br />
== Finding files by URL ==<br />
<br />
Often, people will reference files by URL in emails and other web-sites. When a link to a file stops working, it isn't always obvious where it was originally uploaded to. If you have a file-URL that you want to locate you can find it in the site with the new "Files" feature as follows:<br />
<br />
[[File:Drupal-find-files.png|600px|frameless]]<br />
<br />
* First log into the site<br />
# Click the "Files" link in the edit-console.<br />
# Enter the file-URL in the "Find a File" form.<br />
# Click "Find!"<br />
# Click the edit link of the file to load its settings form in the context of its original container page.<br />
<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Features&diff=42261Drupal Features2022-12-21T20:21:44Z<p>Ian McBride: </p>
<hr />
<div>The features and services which will be available to content managers on the new website, using [[Drupal]].<br />
<br />
__TOC__<br />
<br />
== Drupal Native Features ==<br />
<br />
For the purposes of this article, which is to explain how content managers will interact with [[Drupal]], all features in [[Drupal]] core, contributed [[Drupal]] modules, and Monster Menus are considered "native" features. To content managers, these features will appear as a seamless part of a single system.<br />
<br />
=== Images and Documents ===<br />
<br />
Similar to the current Content Management System, content managers will be able to upload images and documents which they can link in their posts. Unlike the CMS, they will be able to do this while editing their content, rather than as part of a separate document manager.<br />
<br />
Please refer to the [http://wcagsamurai.org/errata/pdf.html Web Content Accessibility Guidelines for use of PDFs] to determine whether documents should be in document format or if their content is better presented as a web page.<br />
<br />
=== Audio and Video ===<br />
<br />
These media formats can be embedded inline in content posts using the format "[video:url_to_video.ext]". The list of 15 supported video sources is available in the [http://drupal.org/project/video_filter Video Filter Module documentation]. We have extended the module to support our local streaming media server, [[MiddMedia]], which is the preferred content repository for locally developed media. All Middlebury users already have access to [[MiddMedia]] with a generous quota. Many departments also have shared space on the server, which can be set up on request to Joe Antonioli.<br />
<br />
=== Profiles ===<br />
<br />
There will be a content type in Drupal that allows you to fetch profile information from the Directory and display it alongside biographical information about the person. This will be similar to how the Faculty profiles operate currently in departmental sites. This will both display information from the online directory and link to the record in the directory.<br />
<br />
=== Tagging ===<br />
<br />
Content managers will be able to tag pages on their site using the [http://drupal.org/handbook/modules/taxonomy Taxonomy module] for [[Drupal]]. Tags will come from a set of global sites tags. Tagging content is a way to relate the content on each site with similar content elsewhere. An example of a tag might be "environment", which could be applied to a story in Dining Services about buying local food. A user clicking on the "environment" tag would then see content related to that topic from anywhere on the Middlebury site.<br />
<br />
For departments which require it, we may also set up a custom "vocabularly". This would allow the department to organize content using a set of tags specific to their function. The need for a custom vocabulary should be identified as part of the content workbook process.<br />
<br />
You may wish to read [http://drupal.org/handbook/modules/taxonomy more details about Taxonomy in Drupal] in the [[Drupal]] handbook.<br />
<br />
=== RSS Aggregation ===<br />
<br />
Content managers will be able to display the contents of a RSS feed as a page in their site. This allows the departments to manage certain content in a blog or other RSS enabled system and then present the content as though it were natively part of the department's CMS site, without requiring the user to visit the blog. In addition to external RSS feeds, content managers will also be able to display feeds of other sites within Drupal. For instance, the Sustainability Integration Office (formerly Environmental Affairs) may choose to display a feed of news items from the Environmental Studies department. Similarly, the "RSS Page" in [[Drupal]] can be used to display feeds of site tags from the Taxonomy system.<br />
<br />
=== Calendaring ===<br />
<br />
Each site will be able to choose to have a calendar which presents events involving their functional area. This calendar will be based on segment criteria from the central scheduling system: Resource 25. It will be the responsiblity of the department to coordinate the input of their events into this system, which should occur with the Events Scheduling Office. This segemented calendar will allow users to subscribe to that department's events via RSS, iCal, vCal, or text messaging. This is the preferred and highly encouraged way to manage event information and there will not be a separate template for events in the new content management system.<br />
<br />
=== Google Maps ===<br />
<br />
Content managers will be able to enter location information into certain content types on their site. They can enter an address or latitude/longitude coordinates. For many (but not all) countries, the system will automatically determine the lat/lon based on address information. This can then be used to build a custom Google Map on the site. MIIS is using this feature to add lat/lon to each of their Stories which will then be used to automatically populate a map of the MIIS Around the World page, allowing users to click on map points and read about the MIIS story happening in that location.<br />
<br />
=== Web Forms ===<br />
<br />
We will use the [http://drupal.org/project/webform Web Form module] for [[Drupal]] which allows departments to do self-service creation of online forms with fields as specified by the content managers. This module also allows the managers to set email delivery of the form results and do conditional emailing of the results (i.e. send the results to Mary if they answered "Yes" to question 3, otherwise send the results to Tom). We will recommend that content authors move their current web based forms into this system as part of their content redevelopment work, if appropriate.<br />
<br />
== Web Features outside of Drupal ==<br />
<br />
Content managers should be aware that [[Drupal]] is not the only content authoring platform supported. Because of our ability to import information using the RSS Page content type, we can create content in other locations and display it as part of the department site, or simply link to it from the department site in the traditional manner.<br />
<br />
=== [[Course Catalog]] ===<br />
<br />
Course information and descriptions will be contained in a central database fed from Banner that can be used to display slices of that information on the departmental sites. This database will contain both information for the current term as well as past and future terms.<br />
<br />
See: [[Course Catalog]]<br />
<br />
=== Blogging ===<br />
<br />
Departments are welcome to create their own department blog in [[WordPress_MU]] our supported blogging platform. They can do so at any time. Several new themes for [[WordPress_MU]] will be delivered as part of the design deliverables from White Whale. Once we have these, departments will be free and encouraged to use them.<br />
<br />
=== Wikis ===<br />
<br />
Department may request a wiki on our [[MediaWiki]] platform. Wikis can be either public or private. A list of changes can be aggregated from the wiki for display in the CMS portion of the departmental web presence.<br />
<br />
=== Search Landing Page ===<br />
<br />
The strategic recommendations document from White Whale specifies that we should create custom search result pages for some number of the top search terms on our search engine. A custom search page is an easy way for a department to get the most relevent information about themselves into a short form. Not all custom search result pages will be for departments, but some may. Departments should think about what information they would want to display in this form and how that would be different from the home page of their departmental site.<br />
<br />
== Requirements for Web Redo Project ==<br />
<br />
The following is a list of requirements culled from documentation produced for the web redo project. Each section refers to the originating document for the requirement. The requirements listed here are those focused on additional development to be done by Middlebury's web developers. Before each line is a link to an article about the feature of Drupal we might use to implement this requirement.<br />
<br />
=== Featured Projects ===<br />
<br />
These will be part of larger development efforts<br />
<br />
* Bookmarking<br />
* [[Course_Catalog|Course Catalog]]<br />
* Microphilanthropy Site<br />
* Search overhaul and search landing pages<br />
* Athletics scoreboard and rosters<br />
<br />
=== White Whale IA/Content Recommendations ===<br />
<br />
==== About Middlebury ====<br />
<br />
* About Middlebury (Home Page)<br />
** [[Drupal_Features_Views|Views]]: targeted news feed<br />
* Out Future<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: news feeds<br />
* Middlebury Campus<br />
** [[Drupal_Features_Gallery|Gallery]]: gallery of campus photos<br />
* President of the College<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: feed of Ron's blog<br />
<br />
==== Academics ====<br />
<br />
* Academics (Home Page)<br />
** Department site navigation element<br />
* Fall Seminars<br />
** Automatic list generated from [[Course Catalog]]<br />
* Spring Seminars<br />
** Automatic list generated from [[Course Catalog]]<br />
* [[Course Catalog]]<br />
** Searchable interface of course listings<br />
* Library<br />
** Search tabs for Library catalog, similar to Amherst site (not a WW recommendation)<br />
* Study Abroad<br />
** [[Drupal_Features_Gallery|Gallery]]: photo gallery based on Study Abroad Photo Contest content<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: feeds of SA blogs, flickr/picasa photo feeds<br />
* Study Abroad Programs<br />
** [[Drupal_Features_Gallery|Gallery]]: photo gallery based on Study Abroad Photo Contest content<br />
* Study Abroad Events<br />
** Calendar of upcoming events, from 25Live<br />
* Academic Calendar<br />
** Calendar of Academic year, from 25Live<br />
<br />
==== Admissions ====<br />
<br />
* Admissions (Home Page)<br />
** [[Drupal_Features_Views|Views]]: rotating student profiles, segemented by type for lower-level pages (i.e. Internationals)<br />
** [[Drupal_Features_Views|Views]]: rotating video/multimedia content with some "sticky" content (i.e. Virtual Tour)<br />
** twitter-style content blurbs (i.e. "Question of the Day" from tour guides)<br />
** [[Drupal_Features_Gallery|Gallery]]: Images of Middlebury photo gallery<br />
* Getting Started<br />
** [[Drupal_Features_Taxonomy|Taxonomy]] & [[Drupal_Features_Views|Views]]: Site-wide FAQ database<br />
** [[Drupal_Features_Webform|Webform]]: Request more information forms in site design (Banner integration?)<br />
** Deadlines calendar<br />
** Scrolling schedule of high school and international site visits<br />
* Who We Are<br />
** [[Drupal_Features_Views|Views]] or [[Drupal_Features_RSS_Page|RSS Page]]: dynamic story feeds<br />
** Search functionality to find counselor based on city, state, and ZIP code<br />
** [[Drupal_Features_Views|Views]]: Paged display of Tour Guides<br />
** Chat room for ISO<br />
<br />
==== Athletics ====<br />
<br />
* Athletics (Home Page)<br />
** Team list dropdown control<br />
** [[Drupal_Features_Views|Views]]: news stories from central news source and team pages<br />
** Upcoming Athletics events and results scoreboard<br />
* News<br />
** [[Drupal_Features_Views|Views]]: latest news stories with feature item and headlines<br />
* SportsNotes<br />
** Newsletter functionality for Drupal<br />
* History & Traditions<br />
** [[Drupal_Features_Gallery|Gallery]]: photo gallery of past athletes and facilities<br />
* Faculty Affiliate Program<br />
** [[Drupal_Features_RSS_Page|RSS_Page]]: blog feed for each affiliated faculty<br />
* Schedule<br />
** Schedule of events fed from scoreboard or 25Live<br />
* Varsity Sports<br />
** [[Drupal_Features_Views|Views]]: rotating featured news story<br />
* Team Pages - basically move all of the sub-page content onto the main page<br />
** Recent news feed<br />
** Results from scoreboard<br />
** Roster from roster database<br />
** Schedule of upcoming events<br />
* Facilities<br />
* Schedule from 25Live<br />
* Prospective Students<br />
** [[Drupal_Features_Webform|Webform]]: Per-team prospective information form<br />
<br />
==== Giving ====<br />
<br />
* Making a Difference<br />
** [[Drupal_Features_Views|Views]]: rotating stories, videos, and other dynamic content<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Impact of Giving aggegates giving content from everywhere<br />
** [[Drupal_Features_GMap|Google Maps]]: Interactive donor story and photo map<br />
** [[Drupal_Features_Gallery|Gallery]]: Photo galleries<br />
* Online Giving Form<br />
** CsXmlForm or Harris: request information about gift planning, reunion. Audience-targeted forms.<br />
** CsXmlForm or Harris: migrate PDF Direct Payment Plan form to these services<br />
* Major Gifts<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: News feeds of major gift related stories<br />
* Request More Information<br />
** [[Drupal_Features_Webform|Webform]]: Port to Webform to use design template<br />
* Middlebury Initiative<br />
** Port existing site into Drupal, possible create templates for MI<br />
* Annual Giving<br />
** [[Drupal_Features_Views|Views]]: dynamic feed of stories<br />
** Calendar of Alumni events<br />
* Community-Inspired Projects<br />
** Microphilanthropy site<br />
* The Middlebury Green Fund<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: blog postings about the Green Fund<br />
** [[Drupal_Features_Views|Views]]: stories about the Green Fund<br />
* Summer Language Schools<br />
** [[Drupal_Features_Views|Views]]: stories about the Language Schools<br />
* Middlebury Schools Abroad<br />
** [[Drupal_Features_Views|Views]]: stories about the Schools Abroad<br />
* MMLA<br />
** [[Drupal_Features_Views|Views]]: stories about the MMLA<br />
* Supporters<br />
** Allow people to log in and view their giving history / volunteer activities<br />
** Add search functionality to Donor Roll<br />
** Have more categories available after log in, True Blue Society, etc.<br />
<br />
==== MiddLabs ====<br />
<br />
* MiddLab (Home Page)<br />
** [[Drupal_Features_Views|Views]]: rotating featured projects / people<br />
** [[Drupal_Features_Views|Views]] & [[Drupal_Features_Taxonomy|Taxonomy]]: "themes" of projects<br />
* Submissions<br />
** [[Monster_Menus_Permissions|Monster Menus Permissions]]: faculty / staff / students can add content, but with a "curator"<br />
** [[Drupal_Features_Webform|Webform]]: Submission form<br />
** [[Drupal_Features_Taxonomy|Taxonomy]]: Add MiddLab tag to news<br />
* What is MiddLab?<br />
** [[Drupal_Features_GMap|Google Maps]]: Show geographical span of MiddLab projects and people<br />
<br />
==== Middlebury International ====<br />
<br />
* Middlebury International (Home Page)<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Aggregation of content from Affiliated programs<br />
* Middlebury Around the World<br />
** [[Drupal_Features_GMap|Google Maps]]: Map of students and stories from around the world<br />
* International Student & Scholar Services<br />
** [[Drupal_Features_Views|Views]] & [[Drupal_Features_RSS_Page|RSS Page]]: aggregated news and multimedia<br />
** [[Drupal_Features_Gallery|Gallery]]: Photo gallery<br />
* ISSS -> Current Students<br />
** Events feed<br />
* Rohatyn Center for International Affairs<br />
** Internal review required to determine how best to display multimedia content<br />
<br />
==== News Room ====<br />
<br />
* News Room (Home Page)<br />
** [[Drupal_Features_Views|Views]]: Features stories list<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Most recent news headlines<br />
** Events calendar listings<br />
** News search<br />
** [[Drupal_Features_Views|Views]]: Featured Faculty Expert<br />
* Middlebury in the News<br />
** Search box with results on this page and search by date and publication<br />
* Midd Blogs<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Aggregate and feature blogs hosted by Middlebury<br />
** Search box for blogs<br />
* Faculty Experts<br />
** Search box with results on this page and search by person or topic<br />
** [[Drupal_Features_Views|Views]]: rotating feed of faculty expert videos<br />
* News Archive<br />
** [[Drupal_Features_Views|Views]]: sort by date or publication<br />
* MULTIMEDIA<br />
** All videos, photo galleries, podcasts aggregated here and able to search by relevant metadata<br />
<br />
==== Office & Services ====<br />
<br />
* Offices & Services (Home Page)<br />
** Quick Access search of page links<br />
** [[Drupal_Features_Subpglist|Sub Page List]] of categorized departments<br />
<br />
==== Student Life ====<br />
<br />
* Student Life (Home Page)<br />
** [[Drupal_Features_Views|Views]]: Rotating news and stories of student life<br />
** [[Drupal_Features_Gallery|Gallery]]: Photo gallery for student life<br />
* Student Organizations<br />
** [[Drupal_Features_Views|Views]]: Quick Access search of student organizations list<br />
* The Commons System<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: News and events feeds, blog feeds<br />
** [[Drupal_Features_Gallery|Gallery]]: Slideshow of images from the dorm rooms<br />
* Diversity at Middlebury<br />
** Integrate the "word wall" from the diversity site<br />
* Diversity Events Calendar<br />
** Information from 25Live<br />
<br />
==== Sustainability ====<br />
<br />
* Sustainability (home page)<br />
** [[Drupal_Features_Views|Views]]: Rotating news and stories about Sustainability<br />
** Events feed for Sustainability<br />
* Climate Change<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Blog feed from MiddShift<br />
** [[Drupal_Features_Views|Views]]: Stories from student groups working on climate change<br />
* Carbon Reduction<br />
** Calculator widget to determine personal carbon footprint<br />
* Energy<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Blog feeds<br />
** [[Drupal_Features_Views|Views]]: Stories from student groups working on energy<br />
* Food<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Blog feeds<br />
** [[Drupal_Features_Views|Views]]: Stories from student groups working on food<br />
* Sustainable Design<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Blog feeds<br />
** [[Drupal_Features_Views|Views]]: Stories from student groups working on sustainable design<br />
* Transportation<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Blog feeds<br />
** [[Drupal_Features_Views|Views]]: Stories from student groups working on transportation<br />
* Resource Management<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Blog feeds<br />
** [[Drupal_Features_Views|Views]]: Stories from student groups working on resource management<br />
* News & Events<br />
** [[Drupal_Features_Views|Views]]: News view<br />
** Events feed from 25Live<br />
<br />
==== The Arts ====<br />
<br />
* The Arts (home page)<br />
** Arts Calendar feed from 25Live<br />
** [[Drupal_Features_Views|Views]]: View of news and stories from the Arts<br />
* News & Events<br />
** Arts Calendar feed from 25Live<br />
** [[Drupal_Features_Views|Views]]: View of news and stories from the Arts<br />
* Join Our Mailing List<br />
** Newsletter feature for Drupal<br />
* Museum of Art<br />
** TBD<br />
* Art on Campus<br />
** [[Drupal_Features_Gallery|Gallery]]: Slideshow of art on campus<br />
** Video tour<br />
* Curricular Connections<br />
** [[Drupal_Features_Views|Views]]: View of news stories about this program<br />
** [[Course_Catalog|Catalog]]: List of courses<br />
** [[Drupal_Features_RSS_Page|RSS Page]]: Blog feeds<br />
<br />
[[Category:Web Application Development]]<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_FAQ&diff=42260Drupal FAQ2022-12-21T20:16:40Z<p>Ian McBride: </p>
<hr />
<div>FAQs can be a great resource for helping new users find information. In Drupal, you will enter each question as a separate piece of content. Each question added will appear, and when clicked on, its answer will be revealed.<br />
<br />
== Creating ==<br />
<br />
<ol><br />
<li>Make sure you are logged on.</li><br />
<li>Navigate to the page you wish to add content to.</li><br />
<li>Locate the "Edit Console" in the top left of the screen. Click the "Add" tab.</li><br />
<ol type="a"><br />
<li>The screen now lists all the content types.</li><br />
</ol><br />
<li>Click the "Frequently Asked Question" link.</li><br />
<ol type="a"><br />
<li>The screen now shows the "Frequently Asked Question" editing interface.</li><br />
</ol><br />
<li>In the "Question" text field, enter the question you wish to display.</li><br />
<li>In the "Answer" text field, enter the answer to your question..</li><br />
<li>If necessary, alter the appearance, set publish dates, and set permissions lists.</li><br />
<ul><br />
<li>Instructions on [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Appearance_2 appearance], [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Scheduling scheduling] and [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Permissions_2 permissions] can be found below.</li><br />
</ul><br />
<li>When you are done adding the content, scroll down and click the "Save" button.</li><br />
<ol type="a"><br />
<li>The screen returns to "View" mode.</li><br />
</ol><br />
</ol><br />
<br />
[[Category:Drupal]]<br />
[[Category:Drupal Content Types]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Facebook_Element&diff=42259Drupal Facebook Element2022-12-21T20:16:24Z<p>Ian McBride: </p>
<hr />
<div>The Facebook Element content type lets you put interactive features from Facebook onto your site. These can either be used to have people interact with your Facebook page or to have people interact with your Drupal page in Facebook (by sharing the page, for example).<br />
<br />
== Creating the Facebook Element ==<br />
<br />
# Navigate to the page where you want the Facebook Element to appear and log in.<br />
# Click '''Add''' in the blue '''Content''' section of the Edit Console.<br />
# Click '''Facebook Element''' in the list of available content types in the middle of the page.<br />
# In the '''URL to Like''' field:<br />
#* If you want to create an element for your Facebook page, enter the URL of that page, e.g. https://www.facebook.com/middleburycollege. If this is a Like Button element, clicking the Like button will Like that Facebook page.<br />
#* If you want to create an element for your Drupal page, enter the URL of that page, e.g. http://www.middlebury.edu/academics/lib. If this is a Like Button element, clicking the Like button will like and share the Drupal page on Facebook.<br />
#* If you want to create an embedded Facebook post, enter the URL of that Facebook post, e.g. https://www.facebook.com/middleburycollege/posts/10153201520307629.<br />
# Enter a '''Width''' for your Facebook Element. The recommended value is 200 for Facebook items in sidebars or 660 for items in the main content region.<br />
# Enter a '''Color Scheme''' for your Facebook Element. If this is on a white background, Light is the recommended option.<br />
# Choose whether to '''Show Faces''' on the Facebook Element. This only applies to Like Buttons and Like Boxes.<br />
# Choose the '''Type''' of Facebook Element to create. See below for a description of the types and their custom options. <br />
<br />
== Embedded Post ==<br />
<br />
Embedded Posts are a simple way to put public posts - by a Page or a person on Facebook - into the content of your web site or web page. Only public posts from Facebook Pages and profiles can be embedded.<br />
<br />
For this option, enter the URL of the Facebook post into the '''URL to Like''' field.<br />
<br />
== Like Button ==<br />
<br />
A single click on the Like button will 'like' pieces of content on the web and share them on Facebook. You may choose to use either the word "Like" or "Recommend" for the button. They both do exactly the same thing, only the word is different. You can also display a Share button next to the Like button to let people add a personal message and customize who they share with.<br />
<br />
There are four layouts available:<br />
<br />
<table><br />
<tr><br />
<th>Standard with Count on Right</th><br />
<td>[[File:Facebook_Button_Standard.png]]</td><br />
</tr><br />
<tr><br />
<th>Button with Count Inside</th><br />
<td>[[File:Facebook_Button_Box.png]]</td><br />
</tr><br />
<tr><br />
<th>Box with Count Above</th><br />
<td>[[File:Facebook_Button_Count.png]]</td><br />
</tr><br />
<tr><br />
<th>Button</th><br />
<td>[[File:Facebook_Button.png]]</td><br />
</tr><br />
</table><br />
<br />
== Like Box / Page Plugin ==<br />
<br />
The Page Plugin (formerly called the Like Box by Facebook) lets you easily embed and promote any Facebook Page on your website. Just like on Facebook, your visitors can like and share the Page without having to leave your site.<br />
<br />
[[File:Facebook_Like_Box.png]]<br />
<br />
== Comments ==<br />
<br />
The Comments Plugin lets people comment on content on your site using their Facebook account. If people wish to they can share this activity to their friends in News Feed as well. It also contains built-in moderation tools and special social relevance ranking.<br />
<br />
The only unique option for the Comments feature is the number of comment threads to show at once.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Drupal Content Types]]<br />
[[Category:Social Media]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Event&diff=42258Drupal Event2022-12-21T20:16:10Z<p>Ian McBride: </p>
<hr />
<div>The [[Drupal]] Event content type can be used to list information about upcoming events. It is formatted to look similar to a list of News stories when presented in a list. This feature was originally only available on the Sustainability section of the site, but can now be used anywhere on the main Middlebury instance of [[Drupal]].<br />
<br />
== Creating ==<br />
<br />
# Make sure you are logged on.<br />
# Navigate to the page where you would like the event to appear.<br />
# Located the "Edit Console" at the top of the page. Click '''Add''' in the blue '''Content''' section.<br />
# Click the '''Event''' link.<br />
## If the '''Event''' link does not appear, please open a Helpdesk ticket and let us know the URL of the page.<br />
# Provide content for each of these fields:<br />
#* '''Title''': this is the title or name of the event.<br />
#* '''Image''': optionally, associate an image with this event.<br />
#* '''Short Description''': a description of the event which will appear in lists of events.<br />
#* '''Date & Time''': when the event will occur.<br />
#** Check '''All Day''' if the event does not occur at a specific time during the day.<br />
#** Check '''Show End Date''' to include an end date or (more often) time for the event.<br />
#** An event can have multiple date and times. Click '''Add another item''' to include more dates.<br />
#* '''Location''': add at least a '''Location Name''', which will appear as the location when the event is show in a list. You can optionally add an address, contact information, and geolocate the event location.<br />
#* '''Body''': the description of the event which will appear when the event is viewed singularly.<br />
# Click '''Save'''.<br />
<br />
Events will appear in "list" form on a page. Clicking on the title will bring you to the singular view.<br />
<br />
== Events Shown as a List ==<br />
<br />
[[File:Drupal Event List.png]]<br />
<br />
== A Single Event ==<br />
<br />
<br />
[[File:Drupal Event Singular.png]]<br />
<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Email_Newsletters&diff=42257Drupal Email Newsletters2022-12-21T20:15:53Z<p>Ian McBride: </p>
<hr />
<div>The preset designs we use for email newsletters are now fully integrated into Drupal's theme system. This means that you can change the theme setting on a page and see the content on that page as it will appear in the newsletter. You can then copy the URL of that page into the List Manager service directly when ready to send your newsletter.<br />
<br />
== Create a New Page for your Newsletter ==<br />
<br />
# Browse to a section of the site where you would like the content for your newsletter to appear and log in.<br />
# Click on '''Add Sub-page''' in the orange '''Sub-pages''' section of the Edit Console.<br />
# Give the page a title, e.g. "MiddNews March 2015"<br />
# Give the page a URL, e.g. "middnews-march-2015"<br />
# Click on the '''Apearance''' tab.<br />
# Under '''Theme for this page and its children''' select the newsletter theme you would like to use, e.g. '''newsletter_middnews_general'''.<br />
# Click the '''Create sub-page''' button at the bottom of the page.<br />
<br />
You can now add your content to the page as normal, either by creating new News or Basic Content nodes, or using the [[Editing_in_Drupal#Pages|Pages]] tab when editing an existing node.<br />
<br />
== Create an Email in List Manager from your Page ==<br />
<br />
# Login into List Manager at http://go.middlebury.edu/lmw and make sure you are in the context of the list you will be sending your newsletter from.<br />
# Click on "Content" and choose "New Content".<br />
# Add "Content Name", "Description" (content name is required).<br />
# Add appropriate "From", "To", "Subject" values.<br />
# Click on the "HTML Message" tab<br />
# Click the "Insert URL" button below the content area.<br />
# Click on the "Web Page" tab.<br />
# Enter the URL of your content and click the "Insert" button. The URL will be the address of the page you created in the '''Create a New Page for your Newsletter''' steps above.<br />
# Click on the "Text Message" tab and the click on the "HTML to Email" button.<br />
# Click the "Create Mailing" button.<br />
# From here you can send a test or send the email.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Lyris]]<br />
[[Category:List Manager]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Development&diff=42256Drupal Development2022-12-21T20:15:38Z<p>Ian McBride: </p>
<hr />
<div>= Development with Git =<br />
<br />
The [http://git-scm.com/documentation Git Documentation] site is a great resource for tutorials and details on all commands. If you are used to Subversion, the [http://git-scm.com/course/svn.html Git-SVN Crash Course] is a good resource.<br />
<br />
== Initial Setup ==<br />
<br />
[https://janus.middlebury.edu/display/WTASDOC/Drupal+7+Development+Site+Installation Moved into Confluence]<br />
<br />
== Browsing History ==<br />
<br />
You can use the command-line program [http://www.kernel.org/pub/software/scm/git/docs/git-log.html git-log] and [http://www.kernel.org/pub/software/scm/git/docs/git-show-branch.html git-show-branch] to browse the history, but a much better experience is provided by the [http://www.kernel.org/pub/software/scm/git/docs/gitk.html gitk] graphical browser.<br />
<br />
gitk can be started from the [http://www.kernel.org/pub/software/scm/git/docs/git-gui.html git-gui's] "Repository" menu, or from the command line:<br />
# SSH to anvil using an XTerm: <pre>ssh -X anvil.middlebury.edu</pre><br />
# cd to the working directory: <pre>cd ~/public_html/drupal/</pre><br />
# open gitk showing all branches: <pre>gitk --all &</pre><br />
<br />
== Committing Customizations ==<br />
<br />
No customizations to Drupal should be made on the '''core''' or '''modules''' branches. These two branches are reserved for code coming directly from third-parties. Keeping our customizations off of these branches allows us to be able to easily see where our modifications to core code and modules reside and to maintain those modifications more easily through upgrades.<br />
<br />
#cd to the working directory: <pre>cd ~/public_html/drupal/</pre><br />
#Ensure that you are on the '''master''' branch (BC:5/27/2011- &nbsp;git-status "command not found" - ask Adam): <pre>git-status</pre> If not, check out your '''master''' branch: <pre>git-checkout master</pre><br />
#Get any changes from the central (origin) repository if desired: <pre>git-pull origin master</pre><br />
#Make some changes to files....<br />
#Stage changes to one or more files: <pre>git-add path/to/desired/file</pre> or stage all changes: <pre>git-add .</pre><br />
#Commit the staged changes to your repository: <pre>git-commit -m "My commit message."</pre><br />
#Repeat steps 4-6 as many times as desired.<br />
#Push your changes to the central repository: <pre>git-push origin master</pre><br />
<br />
=== Push conflicts ===<br />
<br />
Sometimes you get an error like the following when you go to push your changes to the central repository:<br />
<pre>[afranco@chisel drupal-tmp (master)]$ git-push origin master<br />
To git@chisel.middlebury.edu:drupal.git<br />
! [rejected] master -&gt; master (non-fast forward)<br />
error: failed to push some refs to 'git@chisel.middlebury.edu:drupal.git'<br />
</pre><br />
This error indicates that there are new change-sets in the central repository that come after commit that your new changes are based off of. To resolve this issue, the easiest way is to "rebase" your changes on top of those in the central repository. This is done with:<br />
<pre>git-pull --rebase origin master</pre><br />
This is equivalent to:<br />
<pre>git-fetch origin master<br />
git-rebase origin/master</pre><br />
With this command, your change-sets since you diverged from the central repository's '''master''' branch will be set aside, your '''master''' branch updated from the central repository's, then your change-sets will be replayed. Once your repository has been rebased, you can push successfully:<br />
<pre>git-push origin master</pre><br />
<br />
== Adding or Upgrading a Module (Drupal 7) ==<br />
<br />
[https://janus.middlebury.edu/display/WTASDOC/Drupal+7+Module+Updates Moved to Confluence]<br />
<br />
== Adding or Upgrading a Module (Drupal 8) ==<br />
<br />
[https://janus.middlebury.edu/display/WTASDOC/Drupal+8+Module+Updates Moved to Confluence]<br />
<br />
== Managing modules with git subtree ==<br />
Generally we want to use tarball releases from drupal.org since they include version tags in the <code>module.info</code> files that isn't in the repository. However, there are a few modules (such as Lawrence University's MM Tweaks) that don't go through the Drupal.org release process and are only available as a git repository. One option is to download a .zip of their module and add it like others. Alternatively, we can use <code>git subtree</code> to merge their repository (and all of its commits) into our repository under a sub-directory.<br />
<br />
=== Adding ===<br />
# Check out the modules branch for the 3rd party module: <pre>git checkout modules</pre><br />
# You need to get the remote repository's commits into your repository so that they can be referenced: <pre>git remote add mm_tweaks https://github.com/jaydansand/mm_tweaks.git &#10;git fetch mm_tweaks</pre><br />
# Add the external project into a sub-directory. This can be done in two ways:<br />
#* Full history: <pre>git subtree add -P sites/all/modules/mm_tweaks mm_tweaks/master</pre><br />
#* Squashed history: <pre>git subtree add --squash -P sites/all/modules/mm_tweaks mm_tweaks/master</pre> Squashing the history will create a new commit that encompasses the latest state of the module's repository so that our project doesn't include the full history. This is useful for projects with long histories, but prevents us from seeing itemized commits as we update the module.<br />
# Merge onto master: <pre>git checkout master &#10;git merge modules</pre><br />
# Check <code>cookbooks/web_drupal/files/modules_to_uninstall</code> in the Chef project. If the module you added contains sub-modules that will not be enabled, add them to the exclusion list and note this module as their parent.<br />
<br />
=== Updating ===<br />
When managing a module with <code>git subtree</code> you can easily update to the latest version:<br />
# Check out the modules branch for the 3rd party module: <pre>git checkout modules</pre><br />
# Get the latest commits for the module <pre>git fetch mm_tweaks</pre><br />
# Merge the external project's new commits into a sub-directory. This can be done in two ways:<br />
#* Full history: <pre>git subtree merge -P sites/all/modules/mm_tweaks mm_tweaks/master</pre><br />
#* Squashed history: <pre>git subtree merge --squash -P sites/all/modules/mm_tweaks mm_tweaks/master</pre><br />
# Merge onto master: <pre>git checkout master &#10;git merge modules</pre><br />
<br />
=== Moving to releases ===<br />
If the module that you are managing with <code>git subtree</code> moves to the normal release process, you can simply start updating it as you would other modules. No reworking is necessary.<br />
<br />
=== Modules using git subtree ===<br />
{| class="wikitable"<br />
|+Drupal7<br />
!Name<br />
!Path<br />
!Repository URL<br />
!Squash?<br />
|-<br />
|phpCAS<br />
|sites/all/libraries/CAS<br />
|git://github.com/Jasig/phpCAS.git<br />
|yes<br />
|-<br />
|MM Tweaks<br />
|sites/all/modules/mm_tweaks<br />
|https://github.com/jaydansand/mm_tweaks.git<br />
|no<br />
|-<br />
|MM Porter<br />
|sites/all/modules/mmporter<br />
|http://git.drupal.org/sandbox/adamfranco/1475768.git<br />
|no<br />
|-<br />
|NodePorter<br />
|sites/all/modules/nodeporter<br />
|http://git.drupal.org/sandbox/adamfranco/1475756.git<br />
|no<br />
|}<br />
<br />
== Removing a Module ==<br />
Removing a module is like upgrading one, but we use the git-rm command to delete files and stage the deletions.<br />
# cd to the working directory: <pre>cd ~/public_html/drupal/</pre><br />
# This process will wipe out your <code>.htaccess</code> file since it is untracked, so copy it to a location outside of your working directory: <pre>mkdir ~/drupal-settings/; cp .htaccess ~/drupal-settings/</pre><br />
# Check out your '''modules''' branch.<br />
#* You will initially need to create a '''modules''' branch that will track the central repository's '''modules''' branch. Do this with <pre>git-checkout --track -b modules origin/modules</pre><br />
#* If you have already created your '''modules''' branch, use <pre>git-checkout modules</pre> to check out your '''modules''' branch, then <pre>git-pull origin modules</pre> to bring your '''modules''' branch up to date with the central repository's '''modules''' branch.<br />
# cd to the modules directory: <pre>cd sites/all/modules</pre><br />
# Delete the original modules directory: <pre>git-rm -rf modulename</pre><br />
# Commit the deletion: <pre>git-commit -m "Deleted modulename."</pre><br />
# Check out your master branch: <pre>git-checkout master</pre><br />
# Merge the changes from the '''modules''' branch into the master branch: <pre>git-merge modules</pre> Note that any customizations to the module may result in merge conflicts that will need to be resolved (by using git-rm again on the '''master''' branch, then committing.<br />
# Copy your <code>.htaccess</code> file back: <pre>cp ~/drupal-settings/.htaccess .</pre><br />
# Verify that everything is hunky-dory and no dependencies are broken.<br />
# Push all changes in your '''master''' and '''modules''' branches to the matching branches in the central (origin) repository: <pre>git push origin modules</pre> then <pre>git push origin master</pre> These can be both pushed at the same time with <pre>git push origin master modules</pre><br />
# Check <code>cookbooks/web_drupal/files/modules_to_uninstall</code> in the Chef project. If any of the exceptions in the list have the module you just removed as their parent, remove them from the exclusion list.<br />
<br />
== Upgrading the Drupal 7 Core ==<br />
<br />
Upgrading core code is similar to upgrading a module. The only difference to watch out for is that we want to delete everything in our working directory except the <code>.git/</code> directory before we add in the new code.<br />
<br />
# cd to the working directory: <pre>cd ~/public_html/drupal/</pre><br />
# This process will wipe out your settings in <code>.htaccess</code> and <code>sites/default/settings.php</code>, so copy them to a location outside of your working directory: <pre>mkdir ~/drupal-settings/; cp .htaccess sites/default/settings.php ~/drupal-settings/</pre><br />
# Check out your '''core''' branch.<br />
#* You will initially need to create a '''core''' branch that will track the central repository's '''core''' branch. Do this with <pre>git checkout --track -b core origin/core</pre><br />
#* If you have already created your '''core''' branch, use <pre>git checkout core</pre> to check out your '''core''' branch, then <pre>git pull origin core</pre> to bring your '''core''' branch up to date with the central repository's '''core''' branch.<br />
# Delete all files and directories except the .git directory <pre>find . -maxdepth 1 ! -name '.git*' ! -name '.' ! -name '..' -exec rm -Rf {} \;</pre><br />
# Find the latest version<br />
#* [https://drupal.org/node/3060/release?api_version=103 https://drupal.org/node/3060/release?api_version=103]<br />
# Fetch the new Drupal tarball:<br />
#* <pre>wget -O ../drupal.tar.gz https://ftp.drupal.org/files/projects/drupal-7.51.tar.gz</pre><br />
# Decompress the new Drupal tarball: <pre>tar --strip-components 1 -xzf ../drupal.tar.gz</pre><br />
# Delete the new Drupal tarball: <pre>rm ../drupal.tar.gz</pre><br />
# Stage the changes, additions, and removals: <pre>git add -A .</pre><br />
# Commit the changes (and additions/removals): <pre>git commit -m "Upgraded Drupal to version 8.2.1 from tarball."</pre><br />
# Check out your '''modules''' branch: <pre>git checkout modules</pre><br />
# Merge the changes from the '''core''' branch into the '''modules''' branch: <pre>git merge core</pre> Note that any module additions will be retained in the merge.<br />
# While you are on the '''modules''' branch, upgrade any modules that need upgrading (as detailed above).<br />
# Check out your '''master''' branch: <pre>git checkout master</pre><br />
# Merge the changes from the '''modules''' branch into the '''master''' branch: <pre>git merge modules</pre> Note that any customizations should be retained in the merge.<br />
# Copy your <code>.htaccess</code> and <code>sites/default/settings.php</code> back: <pre>cp ~/drupal-settings/.htaccess .; cp ~/drupal-settings/settings.php sites/default/</pre><br />
# Verify that everything is hunky-dory and the new versions of modules work as expected.<br />
# Push all changes in your '''master''', '''core''' and '''modules''' branches to the matching branches in the central (origin) repository: <pre>git push origin master core modules</pre><br />
<br />
== Upgrading the Drupal 8 Core ==<br />
# cd to the working directory: <pre>cd ~/public_html/drupal/</pre><br />
# This process will wipe out your settings in <code>.htaccess</code> and <code>sites/default/settings.php</code>, so copy them to a location outside of your working directory: <pre>mkdir ~/drupal-settings/; cp .htaccess sites/default/settings.php ~/drupal-settings/</pre><br />
# Check out your '''core''' branch.<br />
#* You will initially need to create a '''core''' branch that will track the central repository's '''core''' branch. Do this with <pre>git checkout --track -b core origin/core</pre><br />
#* If you have already created your '''core''' branch, use <pre>git checkout core</pre> to check out your '''core''' branch, then <pre>git pull origin core</pre> to bring your '''core''' branch up to date with the central repository's '''core''' branch.<br />
# run the command <pre>composer update drupal/core --with-dependencies</pre><br />
# Stage the changes, additions, and removals: <pre>git add -A .</pre><br />
# Commit the changes (and additions/removals): <pre>git commit -m "Upgraded Drupal to version 8.3.2 with composer."</pre><br />
# Check out your '''modules''' branch: <pre>git checkout modules</pre><br />
# Merge the changes from the '''core''' branch into the '''modules''' branch: <pre>git merge core</pre> Note that any module additions will be retained in the merge.<br />
# While you are on the '''modules''' branch, upgrade any modules that need upgrading (as detailed above).<br />
# If several merge conflicts arise with the composer.lock file, you can clear out the conflicting changes, run <pre>git checkout --ours composer.lock</pre><br><pre>composer update nothing</pre> to update the lock file based on the current composer.json file.<br />
# Check out your '''master''' branch: <pre>git checkout master</pre><br />
# Merge the changes from the '''modules''' branch into the '''master''' branch: <pre>git merge modules</pre> Note that any customizations should be retained in the merge.<br />
# Copy your <code>.htaccess</code> and <code>sites/default/settings.php</code> back: <pre>cp ~/drupal-settings/.htaccess .; cp ~/drupal-settings/settings.php sites/default/</pre><br />
# Verify that everything is hunky-dory and the new versions of modules work as expected. You may need to run <pre>composer install</pre> to download any additional dependencies to the /vendor directory.<br />
# Push all changes in your '''master''', '''core''' and '''modules''' branches to the matching branches in the central (origin) repository: <pre>git push origin master core modules</pre><br />
<br />
= Git on Windows =<br />
<br />
== Installing&nbsp;Git Extensions ==<br />
<br />
Git Extensions is a toolkit aimed to make working with Git under Windows more intuitive. The shell extension will integrate in Windows Explorer and presents a context menu on files and directories. There is also a Visual Studio plug-in to use Git from Visual Studio.<br />
<br />
Download Git Extension here:<br />
<br />
[http://sourceforge.net/projects/gitextensions/files/Git%20Extensions/Version%201.91/GitExtensions191SetupComplete.msi/download http://sourceforge.net/projects/gitextensions/files/Git%20Extensions/Version%201.91/GitExtensions191SetupComplete.msi/download]<br />
<br />
Launch the Git Extensions installer and follow the installation screens.<br />
<br />
The only changes from the defaults are:<br />
<br />
#On the Select SSH Client, select OpenSSH<br />
#When asked to specify line end support choose the option to leave line endings unchanged<br />
<br />
== Configuration Settings ==<br />
<br />
General client configuration:<br />
<br />
#Launch Git Extensions<br />
#Click on the "settings" menu<br />
#Click on the "Global settings" tab<br />
#Input the proper values for the "User name" and "User email" fields<br />
#Click the "Ok" button<br />
<br />
Creating SSH keys:<br />
<br />
Refer to the Git Extension's User Manual that is installed with Git Extensions.&nbsp; This document can be accessed from the "Help" menu.<br />
<br />
Once the SSH keys have been created, send the public SSH key to Adam Franco<br />
<br />
== Using Git on Windows ==<br />
<br />
There is two ways of using Git On windows.<br />
<br />
#Git Exntesion Gui -&nbsp; use the User Manual for help if needed<br />
#Git Bash - the commands for using Git Bash on windows are the same as they are for Git for Linux.<br />
<br />
Note**: If you are planning to use Git on windows with a samba share, you should clone the project using the windows tool.&nbsp; If you do not use the windows tool in this case there will be issues with file execute permissions, that&nbsp;will cause files to&nbsp;show up as changed.<br />
<br />
== Running git-gui/gitk remotely via X ==<br />
<br />
[http://www.cs.caltech.edu/courses/cs11/misc/xwindows.html This page] describes how to set up an X-server on Windows and use it to display the GUI of graphical applications running on Linux servers.<br />
<br />
While running the graphical Git tools directly on a Windows machine may be sufficient or preferred for many tasks, it can sometimes be advantageous to run GUI programs remotely via X. The primary case for this is to open the graphical tools (gui-gui and gitk) on production machines to allow browsing the history of the the production repository (including configuration changes).<br />
<br />
== Ignoring file-mode changes ==<br />
There are some cases where the file-permissions don't translate properly between Linux hosts and Windows hosts over Samba shares. This can result in Git on one of the platforms showing every file as modified, drastically slowing down the operation of Git.<br />
<br />
To fix this, [http://stackoverflow.com/questions/1580596/how-do-i-make-git-ignore-mode-changes-chmod run the following command while in your working directory]:<br />
<pre>git config core.filemode false</pre><br />
<br />
= Production Deployment =<br />
<br />
The production copies of Drupal code are created just like the development copies: cloning from the central repository. Where they differ slightly is that their '''master''' branches include production configuration commits and therefor diverge from the central-repository's '''master''' branch. Changes made in production will generally not be pushed back to the central repository.<br />
<br />
== Version-control of production configuration ==<br />
<br />
=== Drupal 6 ===<br />
<br />
Unlike the development environments, the '''master''' branch on each webserver has its production configuration committed to it. These branches ''track'' the central repository's '''master''' branch, but diverge from it and include change-sets from the central '''master''' branch as well configuration commits.<br />
<br />
[[Image:DrupalProdConfigBranch.png]]<br />
<br />
After making changes to production config files please commit your changes with a message describing the change.<br />
<pre>git status<br />
git-add .<br />
git-commit -m "Updated configuration with foo and bar."</pre><br />
These configuration change-sets should not be pushed back to the central repository, but will just live in the local repository on each machine.<br />
<br />
=== Drupal 7 ===<br />
<br />
In Drupal 7 we are not version-controlling site configuration files. Make changes on one server, then rsync them to the other two machines:<br />
<br />
Test to see if there is any outstanding config changes with the "dry-run" <code>-n</code> flag:<br />
<pre>rsync -avn /var/www/drupal7/sites/ firehose:/var/www/drupal7/sites/<br />
rsync -avn /var/www/drupal7/sites/ watercannon:/var/www/drupal7/sites/</pre><br />
<br />
If a file is changed, you can see diffs with [http://amjith.blogspot.com/2008/08/quick-and-dirty-vimdiff-tutorial.html <code>vimdiff</code>] using [http://serverfault.com/a/142129/2312 its scp file paths]:<br />
<pre>vimdiff /path/to/file scp://remotehost//path/to/file</pre><br />
<br />
<br />
Make configurations changes on Firehose, then rsync them:<br />
<pre>rsync -av /var/www/drupal7/sites/ firehose:/var/www/drupal7/sites/<br />
rsync -av /var/www/drupal7/sites/ watercannon:/var/www/drupal7/sites/</pre><br />
<br />
== Scripted deployment to Production ==<br />
A Bash script lives on supersoaker that makes use of single-purpose ssh keys to run <code>git-pull</code> on all four webservers. To deploy to all 4 webservers, ssh to supersoaker as root, then run<br />
<pre>deploy_drupal7</pre><br />
Press enter at each prompt to deploy to the next webserver in the list.<br />
<br />
Please test the operation of the new code on [http://drupalmiddadmin.middlebury.edu/ http://drupalmiddadmin.middlebury.edu/] and [http://drupalmiisadmin.middlebury.edu/ http://drupalmiisadmin.middlebury.edu/] before continuing to deploy to the other three webservers.<br />
<br />
== Manually deploying change-sets to Production ==<br />
<br />
Manual updating of production is done by sshing to each webserver then running the following:<br />
<pre>cd /var/www/drupal<br />
git-pull</pre><br />
Note that the working directory must not have any uncommitted changes on it. If configuration changes have been made, please commit them (see below) before running <code>git-pull</code>.<br />
<br />
== Reverting Commits ==<br />
<br />
Let's say that you run a deployment to production but find that it caused more problems than it fixed. To resolve this issue we want to revert the problematic commits. ''Reverting'' means to make a new commit that is the inverse of a previous commit.<br />
<br />
# Find the problematic commit SHA1 id[s].<br />
# Run <pre>git revert XXXXXXX</pre> where <code>XXXXXX</code> is the SHA1 id of the most recent commit you wish to revert. This will create a new commit that undoes <code>XXXXXXX</code>'s changes.<br />
# If you need to revert multiple commits, rerun <code>git revert</code> on the next older commit[s].<br />
# Push your new reverting commits and deploy again.<br />
<br />
If you want to replace the code that you reverted you can simply revert the revert-commits.<br />
<br />
== Resetting Deployments ==<br />
<br />
'''Caution: Use [[Drupal_Development#Reverting Commits]] if at all possible. Resetting will cause way more confusion and be harder to sort out.'''<br />
<br />
Let's say that you run a deployment to production but find that it caused more problems than it fixed. To resolve this issue we want to reset the production drupal directory back to its last operational point. You can do this all from the command line, but using gitk to identify your rollback point makes it much easier to see where you want to go.<br />
<br />
Each deployment results in a merge-commit where the change-sets from the central-repository's '''master''' branch are merged with the production configuration change-sets on the webservers' '''master''' branch. To reset a single deployment, we want to rest to the second-to-last merge-commit.<br />
<br />
=== Resetting with the gitk GUI ===<br />
<br />
#SSH to the first webserver with an XTerm (you could also open an XTerm from the Desktop of the webserver accessed through the VMWare client) and open the history browser, gitk: <pre>ssh -X root@firehose</pre><pre>cd /var/www/drupal</pre><pre>gitk --all &amp;</pre><br />
#You should see a view that looks something like this [[Image:DrupalProdGitk.png]] <br>In this example, the change-set labeled "Fixed a javascript error..." (second from the top) is the one that introduced the issue, so we want to reset to the merge-commit before it was introduced. Locate the merge commit before the problems were introduced.<br />
#Right-click on the merge-commit and choose "Reset master branch to here": [[Image:DrupalProdGitkReset.png]]<br />
#Choose "Hard" as the reset type <br>[[Image:DrupalProdGitkReset2.png]]<br />
#Hit "Ok". This will result in a history that looks like the following: [[Image:DrupalProdGitkReset3.png]] <br>What this shows is that the master branch is now at commit <code>23d8724d017199f58136761eb2ecdfd7442a4db5</code> the later merge-commit still in the repository, but will be removed during the next garbage-collection cycle.<br />
<br />
=== Resetting from the command line ===<br />
Rather than resetting through the GUI, you can also do so through the command line:<br />
<br />
1. Use gitk or git-log to browse the history. Ex:<br />
<pre>git-log</pre><br />
<pre>commit 904c5ea8409e1cbacfffc4b0d6207b40ba04474e<br />
<br />
Merge: 23d8724... 9d0af3b...<br />
Author: root &lt;root@firehose.middlebury.edu&gt;<br />
Date: Thu Apr 15 11:09:35 2010 -0400<br />
<br />
Merge branch 'master' of git@chisel.middlebury.edu:drupal<br />
<br />
commit 9d0af3b3621935527139ad25165411be85700021<br />
Author: Adam Franco &lt;afranco@middlebury.edu&gt;<br />
Date: Thu Apr 15 11:08:58 2010 -0400<br />
<br />
Fixed a javascript error in the library search portal caused by upgrading Views.<br />
<br />
The library Quick-Search portal has a dependency on the jQuery UI Tabs javascript<br />
provided by the Views module.<br />
<br />
In Views 2.10 (commit c41b3281adde3b36307bbd1314a609700dfb4f1c)<br />
the tabs instantiation was moved under the Drupal.Views.Tabs namespace to avoid<br />
conflicts with alternatve versions of jquery, jquery UI.<br />
<br />
commit 23d8724d017199f58136761eb2ecdfd7442a4db5<br />
Merge: ca48b0c... ed71d6e...<br />
Author: root &lt;root@firehose.middlebury.edu&gt;<br />
Date: Thu Apr 15 09:55:53 2010 -0400<br />
<br />
Merge branch 'master' of git@chisel.middlebury.edu:drupal<br />
<br />
commit ed71d6ef087ead838b177e0c77bd704d64a1a6ef<br />
Author: Adam Franco &lt;afranco@middlebury.edu&gt;<br />
Date: Thu Apr 15 09:54:10 2010 -0400<br />
<br />
Added whitespace to test deployment.<br />
<br />
This commit should have no effect on operation and is just used to test deployment.<br />
<br />
...<br />
</pre><br />
<br />
2. Copy the SHA1 ID (in this case, <code>23d8724d017199f58136761eb2ecdfd7442a4db5</code>) of the merge-commit you want to reset to.<br />
<br />
3. Run with that SHA1 ID<br />
<pre>git-reset --hard 23d8724d017199f58136761eb2ecdfd7442a4db5</pre><br />
<br />
== Setting up new sites in production (Drupal 7) ==<br />
<br />
=== Required Configuration ===<br />
<br />
==== Directories ====<br />
Create the sites directory:<br />
<pre>mkdir /var/www/drupal7/sites/www.hostname.edu<br />
cd /var/www/drupal7/sites/www.hostname.edu</pre><br />
<br />
Create the files directory and subdirectories on the network share:<br />
<pre>mkdir /mnt/images/www.hostname.edu<br />
cd /mnt/images/www.hostname.edu<br />
mkdir files<br />
chown apache:apache files/<br />
<br />
# Make a symlink to the high-availability files link in <code>/var/www/images</code><br />
cd /var/www/drupal7/sites/www.hostname.edu/<br />
ln -s /var/www/images/www.hostname.edu/files</pre><br />
<br />
==== Site configuration ====<br />
Copy the default configuration:<br />
<pre>cp ../default/default.settings.php ./settings.php</pre><br />
<br />
Edit the settings.php file and be sure to add at least the following:<br />
<pre># Database<br />
$databases['default']['default'] = array(<br />
'driver' => 'mysql',<br />
'database' => 'ddddddd',<br />
'username' => 'uuuuuuu',<br />
'password' => 'pppppppp',<br />
'host' => 'hhhhhhh.middlebury.edu',<br />
'prefix' => '',<br />
);<br />
<br />
# Who are our proxy servers? So that logs are properly attributed...<br />
$conf['reverse_proxy'] = TRUE;<br />
$conf['reverse_proxy_addresses'] = array('140.233.2.166', '140.233.2.167', '140.233.2.169', '140.233.2.170');<br />
</pre><br />
<br />
==== Apache configuration ====<br />
<br />
Front-end Apache configuration:<br />
<br />
<pre><br />
# Forms Midd site configuration<br />
<VirtualHost *:8080><br />
ServerName www.hostname.edu<br />
# ServerAlias www<br />
ServerAlias hostname.edu<br />
<br />
ServerAdmin webmaster@middlebury.edu<br />
DocumentRoot /var/www/drupal7<br />
ErrorLog "|/bin/logger -t www.hostname.edu -p local3.info"<br />
# Use the client's IP rather than the Varnish Proxy's.<br />
# Append the response time (microseconds) and session cookie value to help with finding slow pages.<br />
CustomLog "|/bin/logger -t www.hostname.edu -p local1.info" "%h \"%{X-Forwarded-For}i\" %l %u \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\" %D %{SSESSxxxxxxxxxxxxxxxxxx}C"<br />
<br />
<Directory /><br />
AddOutputFilterByType DEFLATE text/html text/plain text/css application/x-javascript<br />
<br />
Options FollowSymLinks<br />
AllowOverride All<br />
</Directory><br />
<br />
RewriteEngine on<br />
RewriteRule /\.git/ - [R=404,L]<br />
RewriteRule /(install\.php|CHANGELOG\.txt|INSTALL\.txt|INSTALL\.mysql\.txt|INSTALL\.pgsql\.txt|LICENSE\.txt|MAINTAINERS\.txt|UPGRADE\.txt)(.*)? - [R=403|L]<br />
<br />
# Expand to full host-name<br />
# RewriteCond %{HTTP_HOST} ^www$ [NC]<br />
# RewriteRule ^/(.*) http://www.hostname.edu/$1 [L,R=301]<br />
RewriteCond %{HTTP_HOST} ^hostname.edu [NC]<br />
RewriteRule ^/(.*) http://www.hostname.edu/$1 [L,R=301]<br />
<br />
</VirtualHost><br />
</pre><br />
<br />
Maintenance Apache configuration (for cron jobs). Note that we don't actually need DNS entries for these hostnames as we will target localhost but pass this hostname as the <code>Host:</code> header in the request.<br />
<br />
<pre><br />
<br />
# Forms midd configuration<br />
<VirtualHost *:8080><br />
ServerName hostnameadmin.middlebury.edu<br />
ServerAlias hostnameadmin<br />
<br />
ServerAdmin webmaster@middlebury.edu<br />
DocumentRoot /var/www/drupal7<br />
ErrorLog "|/bin/logger -t www.hostname.edu -p local3.info"<br />
# Use the client's IP rather than the Varnish Proxy's.<br />
# Append the response time (seconds) and session cookie value to help with finding slow pages.<br />
CustomLog "|/bin/logger -t www.hostname.edu -p local1.info" "%h \"%{X-Forwarded-For}i\" %l %u \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\" %D %{SSESSxxxxxxxxxxxxxxx}C"<br />
<br />
<Directory /><br />
AddOutputFilterByType DEFLATE text/html text/plain text/css application/x-javascript<br />
Options FollowSymLinks<br />
AllowOverride All<br />
</Directory><br />
<br />
<IfModule mod_php5.c><br />
php_value memory_limit 0000M<br />
php_value max_input_time 000<br />
php_value max_execution_time 000<br />
</IfModule><br />
<br />
RewriteEngine on<br />
RewriteRule /\.git/ - [R=404,L]<br />
<br />
</VirtualHost><br />
<br />
</pre><br />
<br />
==== Cron jobs ====<br />
<br />
Add one cron job that runs once an hour for basic cleanup tasks:<br />
<pre>23 * * * * if [[ `hostname -s` = "supersoaker" ]]; then curl --silent --header 'Host: hostnameadmin.middlebury.edu' http://localhost:8080/cron.php?cron_key=xxxxxxxxxxxxxxxxxx > /dev/null ; fi</pre><br />
<br />
If needed, add a less frequent cron job to sync users:<br />
<br />
<pre>3 4 * * * if [[ `hostname -s` = "supersoaker" ]]; then curl --silent --header 'Host: hostnameadmin.middlebury.edu' 'http://localhost:8080/cron.php?cron_key=xxxxxxxxxxxxxxx&casmmsync_sync_users=TRUE' > /dev/null ; fi</pre><br />
<br />
==== Deploy scripts ====<br />
<br />
The <code>deploy_drupal7</code> script doesn't need updates, but the cache-clearing script does.<br />
<br />
Edit <code>/usr/local/bin/clear_all_drupal7_caches</code> and add a new line for the new service:<br />
<pre>drush -r /var/www/drupal7/ --uri=http://www.hostname.edu cache-clear all</pre><br />
<br />
<br />
=== Optional configuration -- SSL ===<br />
<br />
Set up certs in Apache on the proxy hosts if they are not already covered.<br />
<br />
Add the following to the site's settings.php:<br />
<pre>/**<br />
* Convince Drupal to make all URLs in content HTTPS even though our<br />
* application server his working without SSL (behind the front-end SSL-terminating Apache and Varnish)<br />
*/<br />
$_SERVER['HTTPS'] = 'on';</pre><br />
<br />
Maybe more is needed?<br />
<br />
=== Optional configuation -- Memcache ===<br />
Set up a new memcache daemon for this site if not upgrading. This is usually hosted on the database server cluster. Each site needs it's own daemon since they will conflict otherwise.<br />
<br />
Add the memcache configuration to the site's settings.php:<br />
<pre># Memcache<br />
$conf['cache_inc'] = './sites/all/modules/memcache/memcache.inc';<br />
$conf['memcache_servers'] = array(<br />
'mmmmmm.middlebury.edu:000000' => 'default',<br />
);</pre><br />
<br />
= Production Notes =<br />
The production environment differs slightly from our development server in a few important ways:<br />
# Drupal caching is done via Memcache rather than in the database.<br />
# Page caching is handled [http://varnish-cache.org/ Varnish] [http://en.wikipedia.org/wiki/Reverse_proxy reverse-proxy] servers that sit in front of each webserver (on the same host machine) and cache anonymous requests (those without session cookies).<br />
# The production environment has two database servers and uses MySQL Proxy to fail over to the secondary one if the primary database goes down.<br />
<br />
For the most part these differences will not result in development problems, but if necessary you can test by deploying to the test5 host which is configured with Memcache, Varnish, MySQL Proxy, and two test database servers.<br />
<br />
== Installing Varnish ==<br />
# Download the Varnish and Varnish-libs RPMs from [http://sourceforge.net/projects/varnish/files/ Source Forge]<br />
# Install expect (to get /usr/bin/mkpasswd which is required by Varnish): <pre>yum install expect</pre><br />
# Install the Varnish libs: <pre>rpm -i varnish-libs-2.x.x-x.el5.x86_64.rpm</pre><br />
# Install Varnish: <pre>rpm -i varnish-2.x.x-x.el5.x86_64.rpm</pre><br />
# Edit <code>/etc/varnish/default.vcl</code> and<br />
## Set the <code>backend default</code> block to <br/><code>backend default {<br/> .host = "127.0.0.1";<br/> .port = "8080";<br/>}</code><br />
## Add the <code>sub vcl_recv</code> block from [https://wiki.fourkitchens.com/display/PF/Configure+Varnish+for+Pressflow https://wiki.fourkitchens.com/display/PF/Configure+Varnish+for+Pressflow].<br />
# Edit <code>/etc/sysconfig/varnish</code> and cange the DAEMON_OPTS line to use malloc rather than file-based caching. Also at the <code>-a :80</code> so that Varnish will listen on port 80. Also set the thread_pools number to match the number of cores on the system as recommended by [http://kristianlyng.wordpress.com/2010/01/26/varnish-best-practices/ this tuning article]. Finally, set the connection timeout a bit higher than default as described by [http://blogs.osuosl.org/gchaix/2009/10/12/pressflow-varnish-and-caching/ http://blogs.osuosl.org/gchaix/2009/10/12/pressflow-varnish-and-caching/] for good measure.<br />
# Set Varnish to start on boot: <pre>chkconfig varnish on</pre><br />
# Edit <code>/etc/httpd/conf/httpd.conf</code> and any vhost config files to set Apache to listen on port 8080.<br />
# Restart Apache.<br />
# Start Varnish.<br />
<br />
== Varnish Tips ==<br />
More information on how Varnish relates to Apache and the rest of the system can be found in [http://blogs.middlebury.edu/lis/2010/05/17/website-performance-pressflow-varnish-oh-my/ this post on the LIS Blog].<br />
<br />
=== Cache Clearing ===<br />
A script has been placed on each production webserver that will clear the Varnish cache on that machine:<br />
<pre>purge_varnish_cache</pre><br />
<br />
This script simply runs the following command: <pre>varnishadm -S /etc/varnish/secret -T localhost:6082 purge.url '.*'</pre><br />
<br />
To clear the Drupal cache tables as well as the Varnish caches on all systems, log into supersoaker and run <pre>clear_all_drupal_caches</pre><br />
<br />
=== Statistics and Info ===<br />
Varnish has a few handy tools that help to visualize its performance.<br />
<br />
==== varnishstat ====<br />
Running <code>varnishstat</code> on a host will show statistics about how Varnish is operating, including cache hits, misses, pass-throughs, memory usage, etc. Read [http://kristian.blog.linpro.no/2009/12/08/varnishstat-for-dummies/ this tutorial] for more info on how to interpret the output.<br />
<br />
==== varnishhist ====<br />
This program creates a histogram of requests where the x-axis is response-time, the y-axis is number of requests. The | character is used for cache hits and the # character signifies requests that are misses or pass-throughs.<br />
<br />
==== varnishncsa ====<br />
Outputs an Apache-style webserver log.<br />
<br />
= Tips and Tricks =<br />
<br />
=== View customizations we've made to a module ===<br />
<pre>git-checkout master<br />
git-diff origin/modules sites/all/modules/webform/</pre><br />
This can also be done on individual files.<br />
<br />
=== Undo customizations to a module ===<br />
<pre>git-checkout master<br />
git-diff -p origin/modules sites/all/modules/webform/ | git-apply -R<br />
git-add sites/all/modules/webform/<br />
git-commit -m "Undid all of our customizations to webform."</pre><br />
<br />
=== Clear uncommitted changes ===<br />
This command will get rid of any uncommitted changes in your working directory. Very handy if you have debugging statements hanging around that you don't want to commit.<br />
<pre>git-reset --hard</pre><br />
<br />
=== Show the current branch in your Bash prompt ===<br />
Add the following to your <code>~/.bashrc</code>:<br />
<pre># Git completion script provides the $__git_ps1 variable<br />
if [ -f /usr/local/share/git-completion.bash ]; then<br />
source /usr/local/share/git-completion.bash<br />
fi<br />
<br />
# Prompt format<br />
export PS1='[\u@\h \W$(__git_ps1 " (%s)")]\$ '</pre><br />
<br />
=== Download and enable coder module in development ===<br />
<br />
In your development environment, run:<br />
<br />
<pre>drush -y pm-enable coder</pre><br />
<br />
If there are no stable releases for coder, you'll be prompted to select a release version. Once selected, coder will be downloaded and enabled.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Web Application Development]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Course_Listing&diff=42255Drupal Course Listing2022-12-21T20:15:06Z<p>Ian McBride: </p>
<hr />
<div>Course Listings can be used to show a filtered list of course titles that can be clicked on to show course descriptions, or a table of sections in the current semester.<br />
<br />
== Creating ==<br />
<br />
# Make sure you are logged on.<br />
# Navigate to the page you wish to add content to.<br />
# Locate the "Edit Console" in the top left of the screen. Click the "Add" tab.<br />
# From the list of available content types, pick the type of course listing you wish to add. Here are the options:<br />
## BLSE Course Listing<br />
## LS Course Listing<br />
## School of the Environment Course Listing<br />
## Undergrad Course Listing<br />
# Add the '''Title''' of the course listing, as you'd like it to appear above the courses.<br />
# Choose '''Courses''' to show a list of course titles that can be clicked on to show course descriptions or '''Sections''' to show a table of course sections in the current semester.<br />
# Now choose one or more of the filtering options to limit which courses are shown in the list. Here are the options:<br />
## Filter by Department<br />
## Filter by Requirement<br />
## Filter by Subject<br />
## Filter by Level (not available in Undergrad Course Listings)<br />
## Filter by Location (not available in Undergrad Course Listings)<br />
## Filter by Additional Details (only available in Undergrad Course Listings)<br />
## Filter by Date<br />
# Optionally, enter a '''Prelude''' of content that you would like to appear between the '''Title'' and the list of courses / sections.<br />
# Click '''Save'''.<br />
<br />
[[Category:Drupal]]<br />
[[Category:Drupal Academics]]<br />
[[Category:Drupal Content Types]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Color_Schemes:_Sun&diff=42254Drupal Color Schemes: Sun2022-12-21T20:14:52Z<p>Ian McBride: </p>
<hr />
<div>[[Drupal|Back to Drupal documentation]]<br />
__NOTOC__<br />
<div class="sun"><br />
<h1 style="border:none;">Heading 1</h1><br />
<p class="opening">You’ve got <em>four years</em> to try new ideas, to explore the subjects and pursuits you feel most passionate about. You’ve got four years to explore a [[Drupal_Color_Schemes|curriculum]] so diverse and interdisciplinary that it would take a century to experience it all.</p><br />
<p>But in those same four years you might act in a [[Drupal_Color_Schemes|student production]], do [[Drupal_Color_Schemes|research]] with faculty scientists, join a [[Drupal_Color_Schemes|relief mission to a country halfway around the world]], sing [[Drupal_Color_Schemes|a capella]], hike the [[Drupal_Color_Schemes|Long Trail]], or play left wing on the [[Drupal_Color_Schemes|hockey team]].</p><br />
<p>We can’t tell you where you’ll wind up. Our job is to help you get started.</p><br />
<p>If you’re just beginning the college application process,[[Drupal_Color_Schemes|start here]]. If you’re ready to apply to Middlebury, [[Drupal_Color_Schemes|here’s the application]]. Some of you might want to read our thoughts on [[Drupal_Color_Schemes|How to Actually Enjoy the Application Process]]. (You know who you are.)</p><br />
<p class="caption">An Image Caption</p><br />
<p class="verybig">Very Big Text</p><br />
<p class="big">Big Text</p><br />
<p class="small">Small Text</p><br />
<p class="fineprint">Fine Print</p><br />
<p class="arabic">Arabic text adds "Simplified Arabic" and "Traditional Arabic" to the font-family list for improved text rendering of Arabic characters.</p><br />
<blockquote><br />
<p>“Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p><br />
<p>“The joy of stylesheets is boundless and endless.”</p><br />
<cite>- This is a blockquote</cite> </blockquote><br />
<p>Donec auctor, enim id euismod mattis, massa elit porta dolor, eget semper leo erat ac neque. Vivamus eget augue sagittis velit ultricies hendrerit. Pellentesque vel condimentum metus. Suspendisse porttitor nunc sed lorem gravida vitae fringilla libero dapibus. Nulla ut interdum nulla. Nulla facilisi.</p><br />
<h2 style="border:none;">Heading 2</h2><br />
<p>In velit urna, accumsan non lacinia eu, eleifend at sem. Nulla non felis ante, ac lobortis sem. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis ipsum magna, suscipit id suscipit sed, vestibulum sit amet orci. </p><br />
<h3 style="border:none;">Heading 3</h3><br />
<p>Ut nec varius odio. Vestibulum vitae ligula sit amet enim accumsan luctus sit amet eget turpis. Donec ultrices, lorem quis commodo volutpat, magna diam vulputate nunc, eu accumsan massa magna quis neque. </p><br />
<h4 style="border:none;">Heading 4</h4><br />
<p>Duis at risus ipsum. Etiam quis felis sit amet neque molestie egestas et quis ligula.</p><br />
<h5 style="border:none;">Heading 5</h5><br />
<p>Aliquam non purus a ligula tempor aliquet. Suspendisse interdum posuere magna eget fringilla. Quisque vitae nibh eget nisl tristique volutpat. Quisque convallis lacinia neque eu facilisis. Fusce bibendum leo nec purus pharetra nec tincidunt dui varius. </p><br />
<h6 style="border:none;">Heading 6</h6><br />
<p>Ut euismod nulla sed odio ultrices nec interdum orci lacinia.</p><br />
<h6>&nbsp;</h6><br />
<p class="date">Date: September 12, 2009</p><br />
<pre style="border:0; padding:0; color:inherit; background-color:inherit; line-height:inherit;"><br />
Start the pre-formatted text in column one.<br />
Then indent to column ten.<br />
Then back five spaces.<br />
</pre><br />
<h6 style="border:none;">Tables</h6><br />
<table><br />
<tr><br />
<th>Recent Gains</th><br />
<th>Floundering</th><br />
<th>Optimism</th><br />
<th>Pushovers</th><br />
<th>T:F</th><br />
</tr><br />
<tr><br />
<td>$100,000</td><br />
<td>Yes</td><br />
<td>80%</td><br />
<td>Steve, Donna</td><br />
<td>5:1</td><br />
</tr><br />
<tr><br />
<td>12 lbs.</td><br />
<td>Yes</td><br />
<td>100%</td><br />
<td>Jeff Bridges</td><br />
<td>1:1</td><br />
</tr><br />
<tr><br />
<td>$40.39</td><br />
<td>No</td><br />
<td>(none)</td><br />
<td>Xavier, Duke</td><br />
<td>1:4</td><br />
</tr><br />
</table><br />
<ul><br />
<li>This is an unordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ul><br />
<ol><br />
<li>This is an ordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ol><br />
</div><br />
<br />
[[Category:Web Application Development]]<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Color_Schemes:_Leaf&diff=42253Drupal Color Schemes: Leaf2022-12-21T20:14:39Z<p>Ian McBride: </p>
<hr />
<div>[[Drupal|Back to Drupal documentation]]<br />
__NOTOC__<br />
<div class="leaf"><br />
<h1 style="border:none;">Heading 1</h1><br />
<p class="opening">You’ve got <em>four years</em> to try new ideas, to explore the subjects and pursuits you feel most passionate about. You’ve got four years to explore a [[Drupal_Color_Schemes|curriculum]] so diverse and interdisciplinary that it would take a century to experience it all.</p><br />
<p>But in those same four years you might act in a [[Drupal_Color_Schemes|student production]], do [[Drupal_Color_Schemes|research]] with faculty scientists, join a [[Drupal_Color_Schemes|relief mission to a country halfway around the world]], sing [[Drupal_Color_Schemes|a capella]], hike the [[Drupal_Color_Schemes|Long Trail]], or play left wing on the [[Drupal_Color_Schemes|hockey team]].</p><br />
<p>We can’t tell you where you’ll wind up. Our job is to help you get started.</p><br />
<p>If you’re just beginning the college application process,[[Drupal_Color_Schemes|start here]]. If you’re ready to apply to Middlebury, [[Drupal_Color_Schemes|here’s the application]]. Some of you might want to read our thoughts on [[Drupal_Color_Schemes|How to Actually Enjoy the Application Process]]. (You know who you are.)</p><br />
<p class="caption">An Image Caption</p><br />
<p class="verybig">Very Big Text</p><br />
<p class="big">Big Text</p><br />
<p class="small">Small Text</p><br />
<p class="fineprint">Fine Print</p><br />
<p class="arabic">Arabic text adds "Simplified Arabic" and "Traditional Arabic" to the font-family list for improved text rendering of Arabic characters.</p><br />
<blockquote><br />
<p>“Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p><br />
<p>“The joy of stylesheets is boundless and endless.”</p><br />
<cite>- This is a blockquote</cite> </blockquote><br />
<p>Donec auctor, enim id euismod mattis, massa elit porta dolor, eget semper leo erat ac neque. Vivamus eget augue sagittis velit ultricies hendrerit. Pellentesque vel condimentum metus. Suspendisse porttitor nunc sed lorem gravida vitae fringilla libero dapibus. Nulla ut interdum nulla. Nulla facilisi.</p><br />
<h2 style="border:none;">Heading 2</h2><br />
<p>In velit urna, accumsan non lacinia eu, eleifend at sem. Nulla non felis ante, ac lobortis sem. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis ipsum magna, suscipit id suscipit sed, vestibulum sit amet orci. </p><br />
<h3 style="border:none;">Heading 3</h3><br />
<p>Ut nec varius odio. Vestibulum vitae ligula sit amet enim accumsan luctus sit amet eget turpis. Donec ultrices, lorem quis commodo volutpat, magna diam vulputate nunc, eu accumsan massa magna quis neque. </p><br />
<h4 style="border:none;">Heading 4</h4><br />
<p>Duis at risus ipsum. Etiam quis felis sit amet neque molestie egestas et quis ligula.</p><br />
<h5 style="border:none;">Heading 5</h5><br />
<p>Aliquam non purus a ligula tempor aliquet. Suspendisse interdum posuere magna eget fringilla. Quisque vitae nibh eget nisl tristique volutpat. Quisque convallis lacinia neque eu facilisis. Fusce bibendum leo nec purus pharetra nec tincidunt dui varius. </p><br />
<h6 style="border:none;">Heading 6</h6><br />
<p>Ut euismod nulla sed odio ultrices nec interdum orci lacinia.</p><br />
<h6>&nbsp;</h6><br />
<p class="date">Date: September 12, 2009</p><br />
<pre style="border:0; padding:0; color:inherit; background-color:inherit; line-height:inherit;"><br />
Start the pre-formatted text in column one.<br />
Then indent to column ten.<br />
Then back five spaces.<br />
</pre><br />
<h6 style="border:none;">Tables</h6><br />
<table><br />
<tr><br />
<th>Recent Gains</th><br />
<th>Floundering</th><br />
<th>Optimism</th><br />
<th>Pushovers</th><br />
<th>T:F</th><br />
</tr><br />
<tr><br />
<td>$100,000</td><br />
<td>Yes</td><br />
<td>80%</td><br />
<td>Steve, Donna</td><br />
<td>5:1</td><br />
</tr><br />
<tr><br />
<td>12 lbs.</td><br />
<td>Yes</td><br />
<td>100%</td><br />
<td>Jeff Bridges</td><br />
<td>1:1</td><br />
</tr><br />
<tr><br />
<td>$40.39</td><br />
<td>No</td><br />
<td>(none)</td><br />
<td>Xavier, Duke</td><br />
<td>1:4</td><br />
</tr><br />
</table><br />
<ul><br />
<li>This is an unordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ul><br />
<ol><br />
<li>This is an ordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ol><br />
</div><br />
<br />
[[Category:Web Application Development]]<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Color_Schemes:_Lake&diff=42252Drupal Color Schemes: Lake2022-12-21T20:14:26Z<p>Ian McBride: </p>
<hr />
<div>[[Drupal|Back to Drupal documentation]]<br />
__NOTOC__<br />
<div class="lake"><br />
<h1 style="border:none;">Heading 1</h1><br />
<p class="opening">You’ve got <em>four years</em> to try new ideas, to explore the subjects and pursuits you feel most passionate about. You’ve got four years to explore a [[Drupal_Color_Schemes|curriculum]] so diverse and interdisciplinary that it would take a century to experience it all.</p><br />
<p>But in those same four years you might act in a [[Drupal_Color_Schemes|student production]], do [[Drupal_Color_Schemes|research]] with faculty scientists, join a [[Drupal_Color_Schemes|relief mission to a country halfway around the world]], sing [[Drupal_Color_Schemes|a capella]], hike the [[Drupal_Color_Schemes|Long Trail]], or play left wing on the [[Drupal_Color_Schemes|hockey team]].</p><br />
<p>We can’t tell you where you’ll wind up. Our job is to help you get started.</p><br />
<p>If you’re just beginning the college application process,[[Drupal_Color_Schemes|start here]]. If you’re ready to apply to Middlebury, [[Drupal_Color_Schemes|here’s the application]]. Some of you might want to read our thoughts on [[Drupal_Color_Schemes|How to Actually Enjoy the Application Process]]. (You know who you are.)</p><br />
<p class="caption">An Image Caption</p><br />
<p class="verybig">Very Big Text</p><br />
<p class="big">Big Text</p><br />
<p class="small">Small Text</p><br />
<p class="fineprint">Fine Print</p><br />
<p class="arabic">Arabic text adds "Simplified Arabic" and "Traditional Arabic" to the font-family list for improved text rendering of Arabic characters.</p><br />
<blockquote><br />
<p>“Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p><br />
<p>“The joy of stylesheets is boundless and endless.”</p><br />
<cite>- This is a blockquote</cite> </blockquote><br />
<p>Donec auctor, enim id euismod mattis, massa elit porta dolor, eget semper leo erat ac neque. Vivamus eget augue sagittis velit ultricies hendrerit. Pellentesque vel condimentum metus. Suspendisse porttitor nunc sed lorem gravida vitae fringilla libero dapibus. Nulla ut interdum nulla. Nulla facilisi.</p><br />
<h2 style="border:none;">Heading 2</h2><br />
<p>In velit urna, accumsan non lacinia eu, eleifend at sem. Nulla non felis ante, ac lobortis sem. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis ipsum magna, suscipit id suscipit sed, vestibulum sit amet orci. </p><br />
<h3 style="border:none;">Heading 3</h3><br />
<p>Ut nec varius odio. Vestibulum vitae ligula sit amet enim accumsan luctus sit amet eget turpis. Donec ultrices, lorem quis commodo volutpat, magna diam vulputate nunc, eu accumsan massa magna quis neque. </p><br />
<h4 style="border:none;">Heading 4</h4><br />
<p>Duis at risus ipsum. Etiam quis felis sit amet neque molestie egestas et quis ligula.</p><br />
<h5 style="border:none;">Heading 5</h5><br />
<p>Aliquam non purus a ligula tempor aliquet. Suspendisse interdum posuere magna eget fringilla. Quisque vitae nibh eget nisl tristique volutpat. Quisque convallis lacinia neque eu facilisis. Fusce bibendum leo nec purus pharetra nec tincidunt dui varius. </p><br />
<h6 style="border:none;">Heading 6</h6><br />
<p>Ut euismod nulla sed odio ultrices nec interdum orci lacinia.</p><br />
<h6>&nbsp;</h6><br />
<p class="date">Date: September 12, 2009</p><br />
<pre style="border:0; padding:0; color:inherit; background-color:inherit; line-height:inherit;"><br />
Start the pre-formatted text in column one.<br />
Then indent to column ten.<br />
Then back five spaces.<br />
</pre><br />
<h6 style="border:none;">Tables</h6><br />
<table><br />
<tr><br />
<th>Recent Gains</th><br />
<th>Floundering</th><br />
<th>Optimism</th><br />
<th>Pushovers</th><br />
<th>T:F</th><br />
</tr><br />
<tr><br />
<td>$100,000</td><br />
<td>Yes</td><br />
<td>80%</td><br />
<td>Steve, Donna</td><br />
<td>5:1</td><br />
</tr><br />
<tr><br />
<td>12 lbs.</td><br />
<td>Yes</td><br />
<td>100%</td><br />
<td>Jeff Bridges</td><br />
<td>1:1</td><br />
</tr><br />
<tr><br />
<td>$40.39</td><br />
<td>No</td><br />
<td>(none)</td><br />
<td>Xavier, Duke</td><br />
<td>1:4</td><br />
</tr><br />
</table><br />
<ul><br />
<li>This is an unordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ul><br />
<ol><br />
<li>This is an ordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ol><br />
</div><br />
<br />
[[Category:Web Application Development]]<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Color_Schemes:_Grape&diff=42251Drupal Color Schemes: Grape2022-12-21T20:14:11Z<p>Ian McBride: </p>
<hr />
<div>[[Drupal|Back to Drupal documentation]]<br />
__NOTOC__<br />
<div class="grape"><br />
<h1 style="border:none;">Heading 1</h1><br />
<p class="opening">You’ve got <em>four years</em> to try new ideas, to explore the subjects and pursuits you feel most passionate about. You’ve got four years to explore a [[Drupal_Color_Schemes|curriculum]] so diverse and interdisciplinary that it would take a century to experience it all.</p><br />
<p>But in those same four years you might act in a [[Drupal_Color_Schemes|student production]], do [[Drupal_Color_Schemes|research]] with faculty scientists, join a [[Drupal_Color_Schemes|relief mission to a country halfway around the world]], sing [[Drupal_Color_Schemes|a capella]], hike the [[Drupal_Color_Schemes|Long Trail]], or play left wing on the [[Drupal_Color_Schemes|hockey team]].</p><br />
<p>We can’t tell you where you’ll wind up. Our job is to help you get started.</p><br />
<p>If you’re just beginning the college application process,[[Drupal_Color_Schemes|start here]]. If you’re ready to apply to Middlebury, [[Drupal_Color_Schemes|here’s the application]]. Some of you might want to read our thoughts on [[Drupal_Color_Schemes|How to Actually Enjoy the Application Process]]. (You know who you are.)</p><br />
<p class="caption">An Image Caption</p><br />
<p class="verybig">Very Big Text</p><br />
<p class="big">Big Text</p><br />
<p class="small">Small Text</p><br />
<p class="fineprint">Fine Print</p><br />
<p class="arabic">Arabic text adds "Simplified Arabic" and "Traditional Arabic" to the font-family list for improved text rendering of Arabic characters.</p><br />
<blockquote><br />
<p>“Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p><br />
<p>“The joy of stylesheets is boundless and endless.”</p><br />
<cite>- This is a blockquote</cite> </blockquote><br />
<p>Donec auctor, enim id euismod mattis, massa elit porta dolor, eget semper leo erat ac neque. Vivamus eget augue sagittis velit ultricies hendrerit. Pellentesque vel condimentum metus. Suspendisse porttitor nunc sed lorem gravida vitae fringilla libero dapibus. Nulla ut interdum nulla. Nulla facilisi.</p><br />
<h2 style="border:none;">Heading 2</h2><br />
<p>In velit urna, accumsan non lacinia eu, eleifend at sem. Nulla non felis ante, ac lobortis sem. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis ipsum magna, suscipit id suscipit sed, vestibulum sit amet orci. </p><br />
<h3 style="border:none;">Heading 3</h3><br />
<p>Ut nec varius odio. Vestibulum vitae ligula sit amet enim accumsan luctus sit amet eget turpis. Donec ultrices, lorem quis commodo volutpat, magna diam vulputate nunc, eu accumsan massa magna quis neque. </p><br />
<h4 style="border:none;">Heading 4</h4><br />
<p>Duis at risus ipsum. Etiam quis felis sit amet neque molestie egestas et quis ligula.</p><br />
<h5 style="border:none;">Heading 5</h5><br />
<p>Aliquam non purus a ligula tempor aliquet. Suspendisse interdum posuere magna eget fringilla. Quisque vitae nibh eget nisl tristique volutpat. Quisque convallis lacinia neque eu facilisis. Fusce bibendum leo nec purus pharetra nec tincidunt dui varius. </p><br />
<h6 style="border:none;">Heading 6</h6><br />
<p>Ut euismod nulla sed odio ultrices nec interdum orci lacinia.</p><br />
<h6>&nbsp;</h6><br />
<p class="date">Date: September 12, 2009</p><br />
<pre style="border:0; padding:0; color:inherit; background-color:inherit; line-height:inherit;"><br />
Start the pre-formatted text in column one.<br />
Then indent to column ten.<br />
Then back five spaces.<br />
</pre><br />
<h6 style="border:none;">Tables</h6><br />
<table><br />
<tr><br />
<th>Recent Gains</th><br />
<th>Floundering</th><br />
<th>Optimism</th><br />
<th>Pushovers</th><br />
<th>T:F</th><br />
</tr><br />
<tr><br />
<td>$100,000</td><br />
<td>Yes</td><br />
<td>80%</td><br />
<td>Steve, Donna</td><br />
<td>5:1</td><br />
</tr><br />
<tr><br />
<td>12 lbs.</td><br />
<td>Yes</td><br />
<td>100%</td><br />
<td>Jeff Bridges</td><br />
<td>1:1</td><br />
</tr><br />
<tr><br />
<td>$40.39</td><br />
<td>No</td><br />
<td>(none)</td><br />
<td>Xavier, Duke</td><br />
<td>1:4</td><br />
</tr><br />
</table><br />
<ul><br />
<li>This is an unordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ul><br />
<ol><br />
<li>This is an ordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ol><br />
</div><br />
<br />
[[Category:Web Application Development]]<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Color_Schemes:_Basic&diff=42250Drupal Color Schemes: Basic2022-12-21T20:13:57Z<p>Ian McBride: </p>
<hr />
<div>[[Drupal|Back to Drupal documentation]]<br />
__NOTOC__<br />
<div class="basic"><br />
<h1 style="border:none;">Heading 1</h1><br />
<p class="opening">You’ve got <em>four years</em> to try new ideas, to explore the subjects and pursuits you feel most passionate about. You’ve got four years to explore a [[Drupal_Color_Schemes|curriculum]] so diverse and interdisciplinary that it would take a century to experience it all.</p><br />
<p>But in those same four years you might act in a [[Drupal_Color_Schemes|student production]], do [[Drupal_Color_Schemes|research]] with faculty scientists, join a [[Drupal_Color_Schemes|relief mission to a country halfway around the world]], sing [[Drupal_Color_Schemes|a capella]], hike the [[Drupal_Color_Schemes|Long Trail]], or play left wing on the [[Drupal_Color_Schemes|hockey team]].</p><br />
<p>We can’t tell you where you’ll wind up. Our job is to help you get started.</p><br />
<p>If you’re just beginning the college application process,[[Drupal_Color_Schemes|start here]]. If you’re ready to apply to Middlebury, [[Drupal_Color_Schemes|here’s the application]]. Some of you might want to read our thoughts on [[Drupal_Color_Schemes|How to Actually Enjoy the Application Process]]. (You know who you are.)</p><br />
<p class="caption">An Image Caption</p><br />
<p class="verybig">Very Big Text</p><br />
<p class="big">Big Text</p><br />
<p class="small">Small Text</p><br />
<p class="fineprint">Fine Print</p><br />
<p class="arabic">Arabic text adds "Simplified Arabic" and "Traditional Arabic" to the font-family list for improved text rendering of Arabic characters.</p><br />
<blockquote><br />
<p>“Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p><br />
<p>“The joy of stylesheets is boundless and endless.”</p><br />
<cite>- This is a blockquote</cite> </blockquote><br />
<p>Donec auctor, enim id euismod mattis, massa elit porta dolor, eget semper leo erat ac neque. Vivamus eget augue sagittis velit ultricies hendrerit. Pellentesque vel condimentum metus. Suspendisse porttitor nunc sed lorem gravida vitae fringilla libero dapibus. Nulla ut interdum nulla. Nulla facilisi.</p><br />
<h2 style="border:none;">Heading 2</h2><br />
<p>In velit urna, accumsan non lacinia eu, eleifend at sem. Nulla non felis ante, ac lobortis sem. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis ipsum magna, suscipit id suscipit sed, vestibulum sit amet orci. </p><br />
<h3 style="border:none;">Heading 3</h3><br />
<p>Ut nec varius odio. Vestibulum vitae ligula sit amet enim accumsan luctus sit amet eget turpis. Donec ultrices, lorem quis commodo volutpat, magna diam vulputate nunc, eu accumsan massa magna quis neque. </p><br />
<h4 style="border:none;">Heading 4</h4><br />
<p>Duis at risus ipsum. Etiam quis felis sit amet neque molestie egestas et quis ligula.</p><br />
<h5 style="border:none;">Heading 5</h5><br />
<p>Aliquam non purus a ligula tempor aliquet. Suspendisse interdum posuere magna eget fringilla. Quisque vitae nibh eget nisl tristique volutpat. Quisque convallis lacinia neque eu facilisis. Fusce bibendum leo nec purus pharetra nec tincidunt dui varius. </p><br />
<h6 style="border:none;">Heading 6</h6><br />
<p>Ut euismod nulla sed odio ultrices nec interdum orci lacinia.</p><br />
<h6>&nbsp;</h6><br />
<p class="date">Date: September 12, 2009</p><br />
<pre style="border:0; padding:0; color:inherit; background-color:inherit; line-height:inherit;"><br />
Start the pre-formatted text in column one.<br />
Then indent to column ten.<br />
Then back five spaces.<br />
</pre><br />
<h6 style="border:none;">Tables</h6><br />
<table><br />
<tr><br />
<th>Recent Gains</th><br />
<th>Floundering</th><br />
<th>Optimism</th><br />
<th>Pushovers</th><br />
<th>T:F</th><br />
</tr><br />
<tr><br />
<td>$100,000</td><br />
<td>Yes</td><br />
<td>80%</td><br />
<td>Steve, Donna</td><br />
<td>5:1</td><br />
</tr><br />
<tr><br />
<td>12 lbs.</td><br />
<td>Yes</td><br />
<td>100%</td><br />
<td>Jeff Bridges</td><br />
<td>1:1</td><br />
</tr><br />
<tr><br />
<td>$40.39</td><br />
<td>No</td><br />
<td>(none)</td><br />
<td>Xavier, Duke</td><br />
<td>1:4</td><br />
</tr><br />
</table><br />
<ul><br />
<li>This is an unordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ul><br />
<ol><br />
<li>This is an ordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ol><br />
</div><br />
<br />
[[Category:Web Application Development]]<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Color_Schemes:_Apple&diff=42249Drupal Color Schemes: Apple2022-12-21T20:13:40Z<p>Ian McBride: </p>
<hr />
<div>[[Drupal|Back to Drupal documentation]]<br />
__NOTOC__<br />
<div class="apple"><br />
<h1 style="border:none;">Heading 1</h1><br />
<p class="opening">You’ve got <em>four years</em> to try new ideas, to explore the subjects and pursuits you feel most passionate about. You’ve got four years to explore a [[Drupal_Color_Schemes|curriculum]] so diverse and interdisciplinary that it would take a century to experience it all.</p><br />
<p>But in those same four years you might act in a [[Drupal_Color_Schemes|student production]], do [[Drupal_Color_Schemes|research]] with faculty scientists, join a [[Drupal_Color_Schemes|relief mission to a country halfway around the world]], sing [[Drupal_Color_Schemes|a capella]], hike the [[Drupal_Color_Schemes|Long Trail]], or play left wing on the [[Drupal_Color_Schemes|hockey team]].</p><br />
<p>We can’t tell you where you’ll wind up. Our job is to help you get started.</p><br />
<p>If you’re just beginning the college application process,[[Drupal_Color_Schemes|start here]]. If you’re ready to apply to Middlebury, [[Drupal_Color_Schemes|here’s the application]]. Some of you might want to read our thoughts on [[Drupal_Color_Schemes|How to Actually Enjoy the Application Process]]. (You know who you are.)</p><br />
<p class="caption">An Image Caption</p><br />
<p class="verybig">Very Big Text</p><br />
<p class="big">Big Text</p><br />
<p class="small">Small Text</p><br />
<p class="fineprint">Fine Print</p><br />
<p class="arabic">Arabic text adds "Simplified Arabic" and "Traditional Arabic" to the font-family list for improved text rendering of Arabic characters.</p><br />
<blockquote><br />
<p>“Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p><br />
<p>“The joy of stylesheets is boundless and endless.”</p><br />
<cite>- This is a blockquote</cite> </blockquote><br />
<p>Donec auctor, enim id euismod mattis, massa elit porta dolor, eget semper leo erat ac neque. Vivamus eget augue sagittis velit ultricies hendrerit. Pellentesque vel condimentum metus. Suspendisse porttitor nunc sed lorem gravida vitae fringilla libero dapibus. Nulla ut interdum nulla. Nulla facilisi.</p><br />
<h2 style="border:none;">Heading 2</h2><br />
<p>In velit urna, accumsan non lacinia eu, eleifend at sem. Nulla non felis ante, ac lobortis sem. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis ipsum magna, suscipit id suscipit sed, vestibulum sit amet orci. </p><br />
<h3 style="border:none;">Heading 3</h3><br />
<p>Ut nec varius odio. Vestibulum vitae ligula sit amet enim accumsan luctus sit amet eget turpis. Donec ultrices, lorem quis commodo volutpat, magna diam vulputate nunc, eu accumsan massa magna quis neque. </p><br />
<h4 style="border:none;">Heading 4</h4><br />
<p>Duis at risus ipsum. Etiam quis felis sit amet neque molestie egestas et quis ligula.</p><br />
<h5 style="border:none;">Heading 5</h5><br />
<p>Aliquam non purus a ligula tempor aliquet. Suspendisse interdum posuere magna eget fringilla. Quisque vitae nibh eget nisl tristique volutpat. Quisque convallis lacinia neque eu facilisis. Fusce bibendum leo nec purus pharetra nec tincidunt dui varius. </p><br />
<h6 style="border:none;">Heading 6</h6><br />
<p>Ut euismod nulla sed odio ultrices nec interdum orci lacinia.</p><br />
<h6>&nbsp;</h6><br />
<p class="date">Date: September 12, 2009</p><br />
<pre style="border:0; padding:0; color:inherit; background-color:inherit; line-height:inherit;"><br />
Start the pre-formatted text in column one.<br />
Then indent to column ten.<br />
Then back five spaces.<br />
</pre><br />
<h6 style="border:none;">Tables</h6><br />
<table><br />
<tr><br />
<th>Recent Gains</th><br />
<th>Floundering</th><br />
<th>Optimism</th><br />
<th>Pushovers</th><br />
<th>T:F</th><br />
</tr><br />
<tr><br />
<td>$100,000</td><br />
<td>Yes</td><br />
<td>80%</td><br />
<td>Steve, Donna</td><br />
<td>5:1</td><br />
</tr><br />
<tr><br />
<td>12 lbs.</td><br />
<td>Yes</td><br />
<td>100%</td><br />
<td>Jeff Bridges</td><br />
<td>1:1</td><br />
</tr><br />
<tr><br />
<td>$40.39</td><br />
<td>No</td><br />
<td>(none)</td><br />
<td>Xavier, Duke</td><br />
<td>1:4</td><br />
</tr><br />
</table><br />
<ul><br />
<li>This is an unordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ul><br />
<ol><br />
<li>This is an ordered list.</li><br />
<li>Vivamus a ante non dui pretium ullamcorper.</li><br />
<li>In velit urna, accumsan non lacinia eu.</li><br />
<li>Nam et aliquam odio!</li><br />
</ol><br />
</div><br />
<br />
[[Category:Web Application Development]]<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Color_Schemes&diff=42248Drupal Color Schemes2022-12-21T20:13:25Z<p>Ian McBride: </p>
<hr />
<div>One of the ways that you can personalize your site is to set it's color scheme. There are six different color schemes available, with names that are meant to describe their color palette.<br />
<br />
*[[Drupal Color Schemes: Apple]]<br />
*[[Drupal Color Schemes: Basic]]<br />
*[[Drupal Color Schemes: Grape]]<br />
*[[Drupal Color Schemes: Lake]]<br />
*[[Drupal Color Schemes: Leaf]]<br />
*[[Drupal Color Schemes: Sun]]<br />
<br />
== White Whale Web Services: Middlebury College Color Study ==<br />
<br />
We began our work on a Middlebury color palette by choosing colors from a variety of Middlebury's print publications. Because Web color is variable and context-dependent, we chose the colors by reviewing the print pieces in person and eyeballing Web equivalents for their primary palette colors (instead of using Pantone colors, for example). And we combined those with some of the values we've used in the inside page section mockups that you've already seen. Here are the results:<br />
<br />
[[Image:Colors.gif|690px]]<br />
<br />
Then we grouped those colors into intuitive groups (with a few colors being used more than once):<br />
<br />
[[Image:Colors-grouped.gif|690px]]<br />
<br />
Then we assigned a ''theme ''to each of these color groupings, based on a Vermont connection. From the top (left to right, top to bottom) the themes are '''''Leaf, Apple, Sun, Lake, Grape, and Basic'''''. (We plan to create at least one more theme— Maple— and welcome the creation of more themes by Middlebury staff.)<br />
<br />
Within these themes, we assigned CSS colors to specific content elements. Each has a specification for'''h1, h4, h5, blockquote''', the opening paragraph, the sidebar box pointers, and three bar colors (that alternate randomly) for each theme.<br><br />
<br />
[[Category:Web Application Development]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Basic_Content&diff=42247Drupal Basic Content2022-12-21T20:08:34Z<p>Ian McBride: </p>
<hr />
<div>The "Basic Content" type will most likely be the content type you use most. It consists of a title and a body section.<br />
<br />
== Creating ==<br />
<br />
<ol><br />
<li>Make sure you are logged on.</li><br />
<li>Navigate to the page you wish to add content to.</li><br />
<li>Locate the "Edit Console" in the top left of the screen. Click the "Add" tab.</li><br />
<ol type="a"><br />
<li>The screen now lists all the content types.</li><br />
</ol><br />
<li>Click the "Basic Content" link.</li><br />
<ol type="a"><br />
<li>The screen now shows the "Basic Content" editing interface.</li><br />
</ol><br />
<li>In the "Title" text field, give your content a title. The title should:<br />
<ul><br />
<li>Accurately convey what information can be found in this content.</li><br />
<li>Front load key words. Users often read only the first few words of a title before deciding if the information they want can be found there.</li><br />
</ul><br />
<li>In the "Body" text field, type your content.<br />
<li>To style an opening paragraph, highlight the text to style and use the "Styles" dropdown menu. The opening paragraph should:<br />
<ul><br />
<li>Summarize what can be found in this content. Users rarely read more than a couple lines before deciding to move on if it is not clear that the information they want can be found there.</li><br />
<li>Be no more than a few sentences</li><br />
</ul><br />
<li>To format a heading, highlight the text to format and use the "Format" dropdown menu.</li><br />
<li>Add the necessary links, images, and videos.</li><br />
<ul><br />
<li>Instructions on adding [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Links links], [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Images images], and [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Video video] can be found below.</li><br />
</ul><br />
<li>If necessary, alter the appearance, set publish dates, and set permissions lists.</li><br />
<ul><br />
<li>Instructions on [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Appearance_2 appearance], [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Scheduling scheduling] and [https://mediawiki.middlebury.edu/wiki/LIS/Editing_in_Drupal#Permissions_2 permissions] can be found below.</li><br />
</ul><br />
<li>When you are done adding the content, scroll down and click the "Save" button.</li><br />
<ol type="a"><br />
<li>The screen returns to "View" mode.</li><br />
</ol><br />
</ol><br />
<br />
[[Category:Drupal]]<br />
[[Category:Drupal Content Types]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Arts_Calendar&diff=42246Drupal Arts Calendar2022-12-21T20:08:20Z<p>Ian McBride: </p>
<hr />
<div>== Creating Arts Calendar Events == <br />
<br />
To create a new Arts Calendar Event:<br />
<br />
* Go to the [http://www.middlebury.edu/arts/news/2016-2017-event-nodes (hidden) test page for Event Nodes]. This page is simply a container for event nodes, and should remain hidden from users. The event display occurs on the Views set up on the visible pages.<br />
* Add a Sub-page for the month (if it doesn't exist), or navigate to the event's month page.<br />
* Add content, and select Event as the type.<br />
* MiddTags: this field '''must''' contain the "Arts Calendar" tag. If it does not, the event will not display on the Arts Calendar Event view.<br />
* Image: the view will size the image to a width of 200px, however the smaller the original uploaded image is, the quicker the Events pages will load.<br />
* Date & Time: each entry will display in an un-ordered list.<br />
<br />
== Displaying Arts Calendar Events by month ==<br />
<br />
To add an Arts Calendar Event view to a page:<br />
<br />
* Go to the [http://www.middlebury.edu/arts/news/2016-2017-events/ (hidden) test page for Events]. You can create a new Sub-page for the month you wish to display.<br />
* Add a Sub-page for the month if it doesn't exist, and navigate to the page.<br />
* Add content and select View Node as the type.<br />
* Enter a title, and in the View to Display field, select '''arts_calendar_events - Block'''.<br />
* In the arguments field, enter the time span in which to display events in the following format: <br />
<br />
''yyyy-mm-dd--yyyy-mm-dd''<br />
<br />
Ex to display March events: '''2017-03-01--2017-03-31'''<br />
* Save the content, and Arts Calendar events tagged as "Arts Calendar" within the indicated date will display on the page.<br />
<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Drupal_Alumni_Profiles&diff=42245Drupal Alumni Profiles2022-12-21T20:08:06Z<p>Ian McBride: </p>
<hr />
<div>Alumni Profiles are a new content type created for academic departments and the Center for Careers & Internships to highlight how alumni are using their Middlebury education in particular fields of study.<br />
<br />
= Images for Alumni Profiles =<br />
<br />
The profiles use two sizes of images which we suggest you prepare in advance.<br />
<br />
<table border="1"><br />
<tr><br />
<th>Image Name</th><br />
<th>Used In</th><br />
<th>Width</th><br />
<th>Height</th><br />
</tr><br />
<tr><br />
<td>Image</td><br />
<td><br />
* Individual profiles<br />
* Lists of profiles<br />
</td><br />
<td>200px</td><br />
<td>260px</td><br />
</tr><br />
<tr><br />
<td>Wide Image</td><br />
<td>* Profile carousels</td><br />
<td>390px</td><br />
<td>260px</td><br />
</tr><br />
</table><br />
<br />
After you have created and sized your images, upload them to Drupal using the [[Editing_in_Drupal#File_upload|instructions on creating File Uploads]]. It is recommended that you create a separate File Uploads page for each department's profile images, to keep them organized.<br />
<br />
= Creating new Alumni Profiles =<br />
<br />
It is up to you how to organize your profiles, but here is a possible information architecture:<br />
<br />
* Office or Department Site<br />
** Alumni Profiles (will show a list of profiles)<br />
*** Alumni #1<br />
*** Alumni #2<br />
*** Alumni #3<br />
<br />
# Create the Alumni Profiles page by [[Editing_in_Drupal#Adding_a_Page|adding a sub-page]] to the department/office site. See the [[Drupal_Alumni_Profiles#Alumni_Profiles_Views|Alumni Profiles Views]] section for information on setting up the lists of profiles later on.<br />
# Create a sub-page of the Alumni Profiles page for each alum whose profile you are going to add.<br />
# On a named alum sub-page, click '''Add''' in the '''Contents''' section of the '''Edit Console'''.<br />
# Click on '''Alumni Profile''' in the list of content types in the center of the page.<br />
# The '''Name''' is the full name of the alum as you wish it to be displayed. Do not include class year.<br />
# Choose the '''Image''' and (if applicable) '''Wide Image''' for the alum that you created and uploaded to the site already. See the [[Drupal_Alumni_Profiles#Images_for_Alumni_Profiles|Images for Alumni Profiles]] section for instructions on this process<br />
# Check the appropriate '''Major(s)''' for this alum. These will be displayed alphabetically in a comma-separated list in list views of alumni profiles.<br />
# Enter the '''Full Job Title''' in the appropriate field. This will be displayed when viewing a single alumni profile.<br />
# Enter the '''Short Job Title''' in the appropriate field, or leave blank to use the value from the '''Full Job Title''' field. This will be displayed when viewing lists of profiles.<br />
# Enter the text for the '''Profile''' of the alum. This will be displayed when viewing a single profile.<br />
# Enter the '''Class Year''' for the alum as a four digit year value with an optional single decimal point, e.g. 2014 or 2014.5.<br />
# Enter the '''Tagline''' for the alum. This is the pull quote that will be displayed when viewing a single alumni profile and in carousels of alumni profiles.<br />
# Click '''Save'''<br />
<br />
= Alumni Profiles Views =<br />
<br />
Lists of Alumni Profiles can be displayed using one of two shortcodes with some additional options.<br />
<br />
<table border="1"><br />
<tr><br />
<th>View Name</th><br />
<th>Shortcode</th><br />
</tr><br />
<tr><br />
<td>Four Column List (CCI Site w/ Sort Dropdown)</td><br />
<td>[view:alumni_profiles=default]</td><br />
</tr><br />
<tr><br />
<td>Carousel</td><br />
<td>[view:alumni_profile_slider=default]</td><br />
</tr><br />
<tr><br />
<td>Auto-cycling Carousel</td><br />
<td>[view:alumni_profile_slider=block_2]</td><br />
</tr><br />
</table><br />
<br />
== Views Arguments ==<br />
<br />
The '''Four Column List''' and '''Carousel''' views accept a '''Major''' as an argument to pre-filter the view. The value for this argument should be the capitalized subject code for the major. For example, to show a Four Column List of History Major alumni, use this shortcode:<br />
<br />
[view:alumni_profiles=default=HIST]<br />
<br />
As a second example, here is the shortcode for a Carousel showing Dance Majors:<br />
<br />
[view:alumni_profile_slider=default=DANC]<br />
<br />
As a third example, here is the shortcode for an auto-cycling Carousel showing Dance and Classics Majors:<br />
<br />
[view:alumni_profile_slider=block_2=DANC+CLAS]<br />
<br />
[[Category:Drupal]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Web_Technologies_%26_Services&diff=42244Web Technologies & Services2022-12-21T20:07:32Z<p>Ian McBride: </p>
<hr />
<div>The Web Technologies & Services workgroup develops custom web applications and customizations to existing web applications, such as [[Drupal|Drupal]] and [[WordPress_MU|WordPress MU]].<br />
<br />
= Resources =<br />
<br />
All of our code is kept in '''Source Control'''. We use git, a distributed source control system. Code that is currently only available internally, such as our custom Drupal themes, are kept in private Github repositories. Some of our projects are maintained in our [https://git.middlebury.edu/git/ on site gitweb repository]. If you would like access to this information, please contact us for the username and password. Our public code is available in the [https://github.com/middlebury/ Middlebury github page], [https://github.com/adamfranco Adam Franco's github page]. Our [http://drupal.org/sandbox/gribnif/1118296 collaboration with Amherst on Monster Menus] is also publicly available.<br />
<br />
= Workgroup Procedures =<br />
<br />
== Web Browser Support ==<br />
<br />
This section applies '''only''' to the [[#Services|applications supported by the Web Technologies & Services group]]. This does not include Banner and INB. For information on those platforms, please see [[Troubleshooting_Banner_and_BannerWeb|Troubleshooting Banner and BannerWeb]].<br />
<br />
Our policy is to make a reasonable effort to support every version of a major web browser (see list below) that is currently supported by the company or group that produces the browser software. If you are using an older version of one of these browsers, our site ''might'' work, but you are encouraged to upgrade. If you are using a development, testing, or beta version of one of these browsers, our site ''might'' work, but we have found there are usually a few glitches that tend to get fixed before the final version is released.<br />
<br />
*[http://www.microsoft.com/en-us/windows/microsoft-edge Microsoft Edge] <br />
*[http://windows.microsoft.com/en-us/internet-explorer/download-ie Internet Explorer 11] <br />
*[http://www.getfirefox.com/ Firefox] <br />
*[http://www.apple.com/safari/ Safari] <br />
*[http://www.google.com/chrome Chrome] <br />
<br />
'''Known Issues''':<br />
<br />
*In Microsoft Edge the right pane of the image selection dialog in Drupal will sometimes not appear. <br />
*Some users on the Middlebury or Monterey networks are unable to load miis.edu sites in Internet Explorer or Microsoft Edge due to a block in the Sophos Web client. If you experience this, you should contact the Helpdesk or use a different browser. <br />
<br />
= Services =<br />
<br />
Web Technologies & Services maintains many web applications for Middlebury. Rather than rely on a single service to manage all needs, we attempt to find ''best of breed'' tools for the most common requests. The [https://servicecatalog.middlebury.edu/contacts/its-web-group full list of services supported by Web Technologies & Services] is available in the Service Catalog.<br />
<br />
&nbsp;<br />
<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Web_Sites&diff=42243Web Sites2022-12-21T20:07:20Z<p>Ian McBride: </p>
<hr />
<div>=Static Web sites=<br />
Throughout the 1990s and early part of this decade, the primary way of delivering content via the web was by building what are known as 'static web pages and sites'. A static website is simply a directory on a [http://en.wikipedia.org/wiki/Webserver Webserver] that contains [http://en.wikipedia.org/wiki/HTML HTML] documents along with images and other linked files. To change the site, the [http://en.wikipedia.org/wiki/HTML HTML] documents would be modified with an [[HTML#Editors | HTML Editor]] and re-uploaded to the webserver, usually via FTP <ref>FTP on Wikipedia http://en.wikipedia.org/wiki/FTP</ref>.<br />
<br />
=Web-Based Publishing Tools=<br />
While many static websites still exist, today most new content on the web is created using a variety of [http://en.wikipedia.org/Web_application web-based applications] that allow users to create and edit content within their browser rather than uploading content created via a desktop application. In addition to simplifying the content-creation process, these web-based tools also enable collaboration by multiple people, discussions and feedback mechanisms, integration with other systems, and a generally richer user-experience than a static website could hope to provide.<br />
<br />
Web-based publishing tools are a rapidly-growing class of software. As the developers of these tools build the best ideas from other tools into their own software, the capabilities and features of any tool will likely overlap with those in other tools both in their category and outside of it. Because of this spectrum of abilities, many tools cannot be easily catargorized or fall into many categories. Here we will try to describe some of the general categories to aid decision as to what software to use for a given purpose.<br />
<br />
==[[Content Management Systems]]==<br />
Content Management Systems (CMS) generally evolved out of the need to better organize and build large websites. Some CMSes treat the 'page' as the basic unit of information, others use smaller chunks of [[micro-content]] as the basic unit of information and organize that micro-content onto pages.<br />
<br />
CMS tools usually provide some sort of hierarchical navigation structure that can be used organize and browse the content of a site. In some CMS tools ([[Segue]]) the navigation structure is automatically generated from the content, in others (Joomla, [[MSCMS]]?) it can be custom-selected from a pool of pages.<br />
<br />
CMS tools often support various content-modules that can allow for the automatic display of calendars, [[RSS]] feeds, or other dynamic content in addition to text.<br />
<br />
[[Content Management Systems | Read more...]]<br />
<br />
==[[Learning Managment Systems]]==<br />
Learning Management Systems (LMS) are tools used in education for disseminating curricular materials and interacting with students. These systems will often support creation and editing of course materials, discussion boards, chat rooms, online testing, drilling, grading, and homework submission. LMSes often have modular designs to allow for the addition of various content or activity types.<br />
<br />
Some LMS tools are highly 'activity' focused, while others are more 'content' focused.<br />
<br />
[[Learning Management Systems | Read more...]]<br />
<br />
==[[Blogs]]==<br />
The term '[[Blogs | Blog]]' (short for 'Weblog') refers to a type of online (web) journal (log). Blogs are usually made up of a series of individual entries that are ordered chronologically such that the most recent items show up at the top of the page. Blog entries are often written by a single person and the blog software usually provides a mechanism for readers to leave comments on each entry. The Blog itself may contain entries authored by a single person (a personal blog) or contain entries authored by many people (such as a news-magazine). <br />
<br />
Blogging tools span a huge range of features and abilities, though they almost all feature chronologically-ordered entries with comments. Many CMS and LMS tools offer support for building blogs. Likewise, many software originally designed for blogging now also support CMS-like or Wiki-like features in addition to the basic blogging support; i.e hierarchically organized pages of non-time-dependent nature.<br />
<br />
[[Blogs | Read more...]]<br />
<br />
==[[Wikis]]==<br />
The term 'Wiki' is the Hawaiian-language term for 'quick'<ref>Wikipedia entry on Wikis. http://en.wikipedia.org/wiki/Wiki</ref>. [[Wikis]] are a form of collaboratively-editable websites, the most famous of which is [http://en.wikipedia.org/wiki/ Wikipedia]. While many CMS tools also allow for collaborative editing of content, Wikis excel at unrestricted and free-form creation. Wikis generally use a simplified markup format, known as [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Wiki-text] and allow for links to pages and topics that do not yet exist. Rather than providing a detailed authorization system to limit who can modify what content, Wikis will instead allow anyone to make changes, but make it easy to roll-back vandalism. This allows wikis to more easily draw a large number of contributers than a more restrictive system, at the expense of control over user-actions.<br />
<br />
[[Wikis | Read more...]]<br />
<br />
<big>'''References'''</big><br />
<references /><br />
<br />
[[Category:Web-Content Platforms]]<br />
[[Category:TDXNO]]</div>Ian McBridehttps://mediawiki.middlebury.edu/LIS/index.php?title=Web_Groups_for_Permissions&diff=42242Web Groups for Permissions2022-12-21T20:06:03Z<p>Ian McBride: </p>
<hr />
<div>= Drupal and MediaWiki&nbsp;Permissions =<br />
<br />
Permission to MediaWiki sites and Drupal sites ([http://www.midd/ www.midd]) are granted through Web Groups. It is easy to setup and maintain (manage) web groups via our website: http://login.middlebury.edu/groups<br />
<br />
#Login to http://login.middlebury.edu/groups <br><br />
#Then select the ‘All Web Groups’ or ’All Groups’ tab to view the groups, members, and owner information. <br><br />
#You can also create your own groups and add members to groups that you own. <br>NOTE:&nbsp;it appears that not everyone can create new web groups.&nbsp;If you need a new web group, please check with the Web&nbsp;Team Members.&nbsp; (Edited by [[User:Petar Mitrevski|Mitrevski, Petar]] 18:29, 25 March 2010 (UTC)) (if you notice that this is no longer true, please update this note).<br />
<br />
<br><br />
<br />
Once you have a web group, you'll need to login to your drupal site and add your group to the approprite permission section.<br />
<br />
= Permissions on other resources (Non-Web Group permissions) =<br />
<br />
Permissions to many other services (including Middfiles) can be granted using the Exchange Admin Center. See [[Managing Group Membership and Permissions]] for more information.<br />
<br />
== Blog permissions ==<br />
WordPress permissions can be managed as for MiddFiles or directly in your WordPress blog.<br />
<br />
<br><br />
<br />
[[Category:Helpdesk Documentation]]<br />
[[Category:Permissions]]<br />
[[Category:File Servers]]<br />
[[Category:E-Mail]]<br />
[[Category:Drupal]]<br />
[[Category:Groups]]<br />
[[Category:MediaWiki]]<br />
[[Category:Public Search]]<br />
[[Category:TDXNO]]</div>Ian McBride