We launched new forums in March 2019—join us there. In a hurry for help with your website? Get Help Now!
    • 34000
    • 77 Posts
    hello, I’m excited to finally have a live revo playground on the web.
    It’s a dev setup for now, but I might post some tutorials if there’s anything worthwhile to share.
    I’m not sure the modx world needs another Installation tutorial.

    Notes on this install on an IIS/shared hosting/ Plesk control panel setup include a few small caveats...
    Which were clearly spelled out by the installation routine, messages below were awesome help:
    (Important Notes:)
    assets/ directory was not created
    You will need to create this directory and make it writable if you want to use Package Management or 3rd Party Components.
    Your assets/components/ directory was not created at:
    You will need to create this directory and make it writable if you want to use Package Management or 3rd Party Components.
    ------
    Had this install up and running in no time, practice pays off!
    The execution time for the install and database setup were stellar fast!
    Thanks one-and-all!
    ------
      MODx Revo 2.1 and done!
      • 17249 ☆ A M B ☆
      • 165 Posts
      I will add the following to that list:


      • If your’re planning on using MODx Revolution Friendly URL’s in Windows (IISv6) you’ll need a component like IIS ModRewrite to handle .htaccess file.
      • Modx ht.access file in the root and core folders needs to be renamed .htaccess to accomplish this. Windows doesn’t allow to change this easily on your local machine in windows xp, instead rename it using ftp on the server or control panel after files are in place. This can be done after installation.
      • If you want urls without file extension attached ej: mysite.com/mypage instead of mysite.com/mypage.html you will need to go to System/Content Types and leave the ’FILE EXTENSION’ field empty on the HTML row. Default is ’.html’

      Having this information handy when installing is a time-saver. Hope it helps.
      Would love to see all this info together as ’installation tips for windows users’ somewhere in the docs.
        • 34000
        • 77 Posts
        Wow awesome info, I just upgarded to an IIS7 server host for the rewrite support. But still didn’t have a clue what I needed to do to get that up and running. Documenting all this sort of stuff, sort of does leave room for a tutorial in the wild.
        Thanks for the timely advice - tips.
        @lithiumlab Are you saying that all I need to do is rename the ht access file to take advantage of mod rewrite, besides changing control panel setting in the revo manager of course.
        It would of been better before installation, I haven’t made any pages or templates yet?
          MODx Revo 2.1 and done!
          • 17249 ☆ A M B ☆
          • 165 Posts
          You can rename the files after installation.
          Clean the cache immediately after changing FURLs system settings and content type. Create a new page give it an alias, save it and preview and you should be good to go. It doesn’t matter if you have resources already created.
            • 34000
            • 77 Posts
            Attempting to just rename the Home document with an alias called index.
            Not working yet. I’m not that familiar with the revo Control panel settings for Furl’s turned those on is about all I did there, and renaming ht.access to .htaccess via ftp.
            I’ll try clearing cache again, hmmm....


            [oops]: from the htaccess files comments looks like I missed this:
            # Make sure RewriteBase points to the directory where you installed MODX.
            # E.g., "/modx" if your installation is in a "modx" subdirectory.

            My base is in a root folder called revo ... checking.

            Changing the rewrite rule also in the .htaccess to make it non-case sensitive sounds like a good idea also?
            ----------
            # You may choose to make your URLs non-case-sensitive by adding a NC directive
            # to your rule: RewriteRule ^(.*)$ index.php?q=$1 [L,QSA,NC]
            ---
            Looks like it’s as easy as adding the NC to the existing rule line down further in the file line: 40 .
              MODx Revo 2.1 and done!
              • 34000
              • 77 Posts
              Does it look like I need to make changes to .htaccess from lines 37-40, if my install is at crssp.com/revo ?
              The doc’s page mentions stuff about domainname.tld I didn’t add that anyplace else?
              http://rtfm.modx.com/display/revolution20/Using+Friendly+URLs

              -----------
              # The Friendly URLs part
              RewriteCond %{REQUEST_FILENAME} !-f
              RewriteCond %{REQUEST_FILENAME} !-d
              RewriteRule ^(.*)$ index.php?q=$1 [L,QSA,NC]
              -------

              would I be better copying the 20 lines of code from the htaccess page in the docs and using that instead of the highly commented sample file that comes with the revo download? The doc’s version seems much more complete.
              http://rtfm.modx.com/display/revolution20/Using+Friendly+URLs

              [trying to give more than I take away... here’s a link to an htaccess cheatsheet]
              http://www.addedbytes.com/cheat-sheets/mod_rewrite-cheat-sheet/
                MODx Revo 2.1 and done!
                • 17249 ☆ A M B ☆
                • 165 Posts
                I didn’t have to change anything on .htaccess file because i was installing on web root.
                Recommend you to not modify anything on .htaccess if thats the case
                (only the RewriteBase in case you have modx installed in a subfolder instead of your web root)

                It appears you have it installed in a subfolder.
                crssp.com/revo
                use: /revo in the .htaccess instead of /

                RewriteEngine On
                RewriteBase /revo


                In system settings i’ve only changed this in my case:
                friendly_urls: Yes
                use_alias_path: Yes
                automatic_alias: Yes (to create alias automatically for new resources)

                Along with clearing the FILE EXTENSION field blank in System/Content Types in the HTML row (in case you want extension-less urls).
                Remember to clear the cache after that.
                  • 34000
                  • 77 Posts
                  My web host seems to think I can’t use the .htaccess file, and must use IIS Rewrite.
                  I asked them for a link to just which IIS Rewrite specs they are talking about.
                  Maybe it will be he just doesn’t understand how MODx works, I’m hoping.
                  I’ll keep toying with it, if I have to give up on Furl’s now I will for a temporary solution.
                  When I get a link from my host I’ll share.
                  Thanks again for all your help. Lithium!
                    MODx Revo 2.1 and done!
                    • 24068
                    • 4 Posts
                    Quote from: lithiumlab at Jun 15, 2011, 12:42 PM

                    RewriteEngine On
                    RewriteBase /revo


                    better add a slash:

                    RewriteEngine On
                    RewriteBase /revo/
                      • 34000
                      • 77 Posts
                      Thanks pureppl, I caught that end with a slash if adding a directory.
                      ----------
                      Here’s what I got back from my host then, regarding the way Furl works on their server:
                      Link to the IIS Rewrite resource:
                      http://www.iis.net/download/urlrewrite
                      If you have a local instance of IIS you can install the module referenced below to do the conversion:
                      http://learn.iis.net/page.aspx/470/importing-apache-modrewrite-rules/
                      ----------
                      Looks like it’s something to dig into anyways, anybody used something like this?
                      At the bottom of the second link page there is this, sounds even more appropriate, digging...
                      http://learn.iis.net/page.aspx/557/translate-htaccess-content-to-iis-webconfig/
                      So it’s sounds like I need to rewrite it to a web.config file sad
                        MODx Revo 2.1 and done!