{"id":417,"date":"2018-01-15T10:03:29","date_gmt":"2018-01-15T14:03:29","guid":{"rendered":"https:\/\/wordpress.ocps.net\/presenceblog\/?p=417"},"modified":"2018-05-11T10:04:53","modified_gmt":"2018-05-11T14:04:53","slug":"document-names-vs-titles","status":"publish","type":"post","link":"https:\/\/wordpress.ocps.net\/presenceblog\/document-names-vs-titles\/","title":{"rendered":"Document Names vs Titles"},"content":{"rendered":"<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">If you previously uploaded PDF documents to the School Messenger portal, you may have noticed that it is not possible for the average person to delete uploaded documents. This restriction was applied by design to prevent the creation of broken links when a document was either removed from the File Manager or renamed. On the other hand, this restriction may represent a challenge to you if you include the year (calendar or school) in the name of the file because you need to update the document each year. I understand that this may have been the way you learned how to store files in your local hard drive or even network drives, however, when dealing with web content management systems such as a portal which builds links to documents, there is a better way to manage your files.<br \/>\n<\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI;\"><span style=\"font-size: 14pt;\"><strong>The Problem <\/strong><\/span><span style=\"font-size: 10pt;\"><br \/>\n<\/span><\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">If you store documents in a Web Content Management system with the year in the document name, that year reference becomes a part of the link that people use to reference the document. That is great until the next year rolls around and a new version of the document must be uploaded. Then it becomes a challenge to find all the links to the old document and change those links to the new document with the new year in the name. Even if you change all the links on your website to point to the new document, you may not be aware of other departments\/schools who also linked to last year&#8217;s document. Finally, even if you could do that, you cannot update the shortcut links people may have added to their desktops to last year&#8217;s document. Thus, they will continue to reference the old document totally unaware that there is a new version. So, what should you do?<br \/>\n<\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI;\"><span style=\"font-size: 14pt;\"><strong>The Solution <\/strong><\/span><span style=\"font-size: 10pt;\"><br \/>\n<\/span><\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">The solution could be as simple as understanding the difference between a document name and its title. A document name is the physical string of characters that define the name of the document in the file manager and it is the string of characters used to create links. On the other hand, the document title is a &#8216;user-friendly&#8217; name for the document that is displayed to the user. It may or may not be stored with the document\/file. What does that mean? Simply that if you keep the document name the same from one year to the next by NOT including the year in the name, the file is only stored once and new versions will overwrite the old versions (assuming you check the overwrite option when uploading the document). However, you can optionally insert the year in the &#8216;title&#8217; of the document in the hyperlink to assure the user that the document has been updated for the current year.<br \/>\n<\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">In the hyperlink manager (when adding a link in a document to an uploaded file), this can be managed by entering a document name (URL) without the year and the document title (Link Text) with the year included:<br \/>\n<\/span><\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.ocps.net\/wp-content\/uploads\/2018\/05\/051118_1341_DocumentNam1.png\" alt=\"\" \/><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\"><br \/>\n<\/span><\/p>\n<p><span style=\"color: #5b9bd5; font-family: Segoe UI; font-size: 10pt;\"><em>(<strong>NOTE:<\/strong> The document container does not support a method to have both a name and title for a file.) <\/em><span style=\"color: #444444;\"><br \/>\n<\/span><\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">When dealing with pages that must be updated from one year to another, it is just as easy to achieve this goal. When creating a new page, include the year in the TITLE, but not in the NAME of the page in the NEW PAGE dialog.<br \/>\n<\/span><\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.ocps.net\/wp-content\/uploads\/2018\/05\/051118_1341_DocumentNam2.png\" alt=\"\" \/><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\"><br \/>\n<\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">Then the TITLE of the page can be changed next year (just edit the page properties) without changing the page NAME and thus no links will be broken nor will any links need to be updated yet references to the page in the portal navigation which displays the Title will show the new year.<br \/>\n<\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">But what if you need to keep versions of documents for prior years?<br \/>\n<\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">Again, the solution here is relatively simple. It involves using two parallel folders, one for the current year, whatever that may be, and an archive folder for all prior year versions (perhaps including the current year). In the current year folder, the document name again must not include the year itself (or other date identifier). That way, a new version can simply replace the old version. Any page references to the current document if pointed to files in this folder will not need to be updated because the document name will never change from year to year. In the second, archive folder, the document name can and should include the year (or date identifier) so that the documents can be listed chronologically and so users can select a document that applies to any specific time period.<br \/>\n<\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">Yes, it may seem like a little more work when uploading a document or uploading changes to an existing document to store the document twice, in two different folders. However, the problems you will avoid when the year changes by not having to update pages and links with the new document name will be well worth the extra effort now.<br \/>\n<\/span><\/p>\n<p><span style=\"color: #444444; font-family: Segoe UI; font-size: 10pt;\">Still not sure about how to do this? <a href=\"http:\/\/signmeup.ocps.net\/\"><span style=\"color: blue; text-decoration: underline;\">Sign up<\/span><\/a> to attend the next open lab February 12, 2018 (Click Technology in the first page menu).<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>If you previously uploaded PDF documents to the School Messenger portal, you may have noticed that it is not possible for the average person to delete uploaded documents. This restriction was applied by design to prevent the creation of broken links when a document was either removed from the File Manager or renamed. On the &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/wordpress.ocps.net\/presenceblog\/document-names-vs-titles\/\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Document Names vs Titles&#8221;<\/span><\/a><\/p>\n","protected":false},"author":8,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[33,34],"tags":[51],"class_list":["post-417","post","type-post","status-publish","format-standard","hentry","category-post-that-explains-how-to-perform-a-specific-activity","category-something-to-think-about-related-to-web-sites","tag-tips"],"jetpack_featured_media_url":"","jetpack-related-posts":[{"id":1668,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/create-a-school-site-newsletter-infrastructure\/","url_meta":{"origin":417,"position":0},"title":"Create a School Site Newsletter Infrastructure","author":"Carlos Hernandez","date":"March 24, 2021","format":false,"excerpt":"Goal: To create two links under School Information that will represent: A link to the current version of your school newsletter A link to a page that contains an archive of school newsletters using a document container. To begin: Open your school site in your favorite browser. If you are\u2026","rel":"","context":"In &quot;How-To&quot;","block_context":{"text":"How-To","link":"https:\/\/wordpress.ocps.net\/presenceblog\/category\/post-that-explains-how-to-perform-a-specific-activity\/"},"img":{"alt_text":"The document container only shows the folders after the files have been moved into folders","src":"https:\/\/i0.wp.com\/wordpress.ocps.net\/wp-content\/uploads\/2021\/03\/032421_1626_CreateaScho19.png?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]},{"id":1056,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/accessibility-tips-for-april-3-2019\/","url_meta":{"origin":417,"position":1},"title":"Accessibility Tips for April 3, 2019","author":"Carlos Hernandez","date":"April 3, 2019","format":false,"excerpt":"Never Link to Microsoft Word, Excel, or PowerPoint Files All Microsoft Word, Excel, and PowerPoint documents (which I refer to as Microsoft source files) should be saved as a PDF file. These should never be directly uploaded to your website because not all users may be able to download these\u2026","rel":"","context":"In &quot;Tips\/Tricks&quot;","block_context":{"text":"Tips\/Tricks","link":"https:\/\/wordpress.ocps.net\/presenceblog\/category\/post-showing-a-specific-tip-or-trick-related-to-web-sites\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":832,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/creating-your-accessible-pdf-from-word\/","url_meta":{"origin":417,"position":2},"title":"Creating Your Accessible PDF from Word","author":"Carlos Hernandez","date":"September 24, 2018","format":false,"excerpt":"Now that you have a Word Document that is accessible, how can you create a PDF that you can distribute to others outside of OCPS. Since the 2007 version of Word, you have had an option to change the file type when you save a document. In the Save As\u2026","rel":"","context":"In &quot;ADA News&quot;","block_context":{"text":"ADA News","link":"https:\/\/wordpress.ocps.net\/presenceblog\/category\/portal-related-news\/news-related-to-ada-and-accessibility\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":569,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/getting-your-site-ready-for-the-end-of-the-school-year\/","url_meta":{"origin":417,"position":3},"title":"Getting Your Site Ready for the End of the School Year","author":"Carlos Hernandez","date":"May 15, 2018","format":false,"excerpt":"We are quickly approaching the end of another school year. Therefore, it is time to take stock of your web site content. It does not matter if your site is a school site or an internet or intranet site. It is still a good time to review the content you\u2026","rel":"","context":"In &quot;Getting Ready for the New School Year&quot;","block_context":{"text":"Getting Ready for the New School Year","link":"https:\/\/wordpress.ocps.net\/presenceblog\/category\/portal-related-news\/news-related-specifically-to-school-sites\/getting-ready-for-the-new-school-year\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":652,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/links-to-district-provided-policy-documents\/","url_meta":{"origin":417,"position":4},"title":"Links to District Provided Policy Documents","author":"Carlos Hernandez","date":"July 2, 2018","format":false,"excerpt":"As part of my summer Getting Ready for the New School Year series, this post looks at some common policy documents provided and maintained by the district offices. You should always point to these documents for any policy references. Attendance Handbook: https:\/\/www.ocps.net\/UserFiles\/Servers\/Server_54619 \/File\/Frequently Updated Documents\/Attendance Policy and Procedures.pdf Bell Schedule\u2026","rel":"","context":"In &quot;Getting Ready for the New School Year&quot;","block_context":{"text":"Getting Ready for the New School Year","link":"https:\/\/wordpress.ocps.net\/presenceblog\/category\/portal-related-news\/news-related-specifically-to-school-sites\/getting-ready-for-the-new-school-year\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":751,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/accessibility\/","url_meta":{"origin":417,"position":5},"title":"Thinking About Accessibility of PDFs on your Website","author":"Carlos Hernandez","date":"August 28, 2018","format":false,"excerpt":"First, let me be clear that accessibility is for everyone, not just the visually impaired. Some aspects of accessibility are directed toward those who have reasonably good vision or hearing and are meant to make documents easier to understand. Other aspects are directed toward users who need to use screen\u2026","rel":"","context":"In &quot;ADA News&quot;","block_context":{"text":"ADA News","link":"https:\/\/wordpress.ocps.net\/presenceblog\/category\/portal-related-news\/news-related-to-ada-and-accessibility\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/posts\/417","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/users\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/comments?post=417"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/posts\/417\/revisions"}],"wp:attachment":[{"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/media?parent=417"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/categories?post=417"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/tags?post=417"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}