{"id":1013,"date":"2019-02-28T15:55:24","date_gmt":"2019-02-28T20:55:24","guid":{"rendered":"https:\/\/wordpress.ocps.net\/presenceblog\/?p=1013"},"modified":"2019-04-03T11:55:53","modified_gmt":"2019-04-03T15:55:53","slug":"invalid-characters-in-file-names","status":"publish","type":"post","link":"https:\/\/wordpress.ocps.net\/presenceblog\/invalid-characters-in-file-names\/","title":{"rendered":"Invalid Characters in File Names"},"content":{"rendered":"<p>When you upload a PDF or other file to the Portal, you have to avoid invalid characters in the URL of the filename.  On the internet, you will find various lists of characters that are valid and those that are not.  However, they do not always differentiate between characters that can be part of the name and characters used to separate parameters from the file name or characters used to as escape character sequences.  The bottom line to me is the only valid characters are:\n<\/p>\n<p>\u00a0\u00a0\u00a0\u00a0Uppercase letters\n<\/p>\n<p>\u00a0\u00a0\u00a0\u00a0Lowercase letters\n<\/p>\n<p>\u00a0\u00a0\u00a0\u00a0Numbers\n<\/p>\n<p>\u00a0\u00a0\u00a0\u00a0Characters:   _    +   and   &#8211;\n<\/p>\n<p>\u00a0\u00a0\u00a0\u00a0You can use a blank character in a filename, but don&#8217;t.  I&#8217;ll discuss this in a moment.\n<\/p>\n<p>How can you tell if the characters in your filename are valid?  If you upload a file using SchoolMessenger&#8217;s File Manager, you should be able to double click on the filename and display the file in a small window.  In the first image below, you can see several files that have a plus sign used to separate words rather than blank spaces.  Some systems automatically convert spaces in a URL to the escape sequence %20; which consumes 3 bytes rather than 1 byte in the URL string which has a limited length.  In SchoolMessenger, when you name a new page, it replaces spaces with an underscore &#8216;_&#8217;.  Why not be consistent and always use an underscore?\n<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.ocps.net\/wp-content\/uploads\/2019\/02\/022819_2055_InvalidChar1.png\" alt=\"\"\/>\n\t<\/p>\n<p>Notice in this images, when I double clicked DRUGS+INHALANTS.pdf, the file window displayed a navigation structure from the <strong>Select a School<\/strong> dropdown and if you scroll down further, it will tell you that the file you clicked on could not be found?  &#8220;Could not be found?&#8221; you say.  But I just clicked on it.  Well the plus sign &#8216;+&#8217; is not treated as a character in the name and causes the URL to go a little &#8216;wonky&#8217;.  But you can easily fix this.\n<\/p>\n<p>Simply right click the filename to display the dropdown menu and select <strong>Rename<\/strong> as shown in the next figure.\n<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.ocps.net\/wp-content\/uploads\/2019\/02\/022819_2055_InvalidChar2.png\" alt=\"\"\/>\n\t<\/p>\n<p>This action displays the Rename dialog box that allows you to edit the filename.  In this case, I replaced the plus sign with an underscore (to be consistent).\n<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.ocps.net\/wp-content\/uploads\/2019\/02\/022819_2055_InvalidChar3.png\" alt=\"\"\/>\n\t<\/p>\n<p>Now when I double-click the renamed file, it correctly opens the PDF.\n<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.ocps.net\/wp-content\/uploads\/2019\/02\/022819_2055_InvalidChar4.png\" alt=\"\"\/>\n\t<\/p>\n<p>At this point I could correct the rest of the file names in the folder and be done.\n<\/p>\n<p>Almost\u2026\n<\/p>\n<p>If you already referenced the files in a hyperlink somewhere on your website, you will need to find those references and correct the spelling of the hyperlink there as well and republish the page.\n<\/p>\n<p>Now you are done.\n<\/p>\n<p>\n\u00a0<\/p>\n<p>\n\u00a0<\/p>\n","protected":false},"excerpt":{"rendered":"<p>When you upload a PDF or other file to the Portal, you have to avoid invalid characters in the URL of the filename. On the internet, you will find various lists of characters that are valid and those that are not. However, they do not always differentiate between characters that can be part of the &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/wordpress.ocps.net\/presenceblog\/invalid-characters-in-file-names\/\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Invalid Characters in File Names&#8221;<\/span><\/a><\/p>\n","protected":false},"author":8,"featured_media":0,"comment_status":"open","ping_status":"closed","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":[36],"tags":[84],"class_list":["post-1013","post","type-post","status-publish","format-standard","hentry","category-post-showing-a-specific-tip-or-trick-related-to-web-sites","tag-invalid-characters-in-file-names"],"jetpack_featured_media_url":"","jetpack-related-posts":[{"id":1668,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/create-a-school-site-newsletter-infrastructure\/","url_meta":{"origin":1013,"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":1371,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/alt-text-for-informative-images\/","url_meta":{"origin":1013,"position":1},"title":"Alt-Text for Informative Images","author":"Carlos Hernandez","date":"January 9, 2020","format":false,"excerpt":"What is an informative image when applied to a webpage? It is any image that adds materially to the understanding of the other text on the page. The alt-text, in this case, should be short, no more than a sentence, which expresses the meaning or purpose of the image. There\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":"District Phone Number","src":"https:\/\/i0.wp.com\/wordpress.ocps.net\/wp-content\/uploads\/2020\/01\/010920_1704_AltTextforI1.png?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]},{"id":1467,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/style-and-image-sizing\/","url_meta":{"origin":1013,"position":2},"title":"Style and Image Sizing","author":"Carlos Hernandez","date":"March 13, 2020","format":false,"excerpt":"If image sizing for web pages seems to be an area that confuses you, this blog post is for you. Automatically Optimize\u00a0Image\u00a0Sizes (Excerpted from the SchoolMessenger built-in help about image resizing.) Many\u00a0images\u00a0that you wish to use on your site are much larger than is necessary. For example, depending on the\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":"Formula to calculate desired Image Height","src":"https:\/\/i0.wp.com\/wordpress.ocps.net\/wp-content\/uploads\/2020\/03\/031020_1739_StyleandIma1.png?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]},{"id":569,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/getting-your-site-ready-for-the-end-of-the-school-year\/","url_meta":{"origin":1013,"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":417,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/document-names-vs-titles\/","url_meta":{"origin":1013,"position":4},"title":"Document Names vs Titles","author":"Carlos Hernandez","date":"January 15, 2018","format":false,"excerpt":"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\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":"","src":"","width":0,"height":0},"classes":[]},{"id":1387,"url":"https:\/\/wordpress.ocps.net\/presenceblog\/alt-text-for-decorative-images\/","url_meta":{"origin":1013,"position":5},"title":"Alt Text for Decorative Images","author":"Carlos Hernandez","date":"January 12, 2020","format":false,"excerpt":"What is a decorative image when applied to a webpage? It is any image that does not add information to the content of the page. It could be part of the page design such as a border around the page, a border around a paragraph or topic, or even horizontal\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":"Example of images used as part of the page design","src":"https:\/\/i0.wp.com\/wordpress.ocps.net\/wp-content\/uploads\/2020\/01\/011020_1957_AltTextforD1.png?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]}],"jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/posts\/1013","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=1013"}],"version-history":[{"count":1,"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/posts\/1013\/revisions"}],"predecessor-version":[{"id":1014,"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/posts\/1013\/revisions\/1014"}],"wp:attachment":[{"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/media?parent=1013"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/categories?post=1013"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.ocps.net\/presenceblog\/wp-json\/wp\/v2\/tags?post=1013"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}